1. Home
  2. General
  3. WebHooks Integration with WishList Member
  1. Home
  2. API
  3. WebHooks Integration with WishList Member

WebHooks Integration with WishList Member

Included in WishList Member Pro

Click Here for more information on WishList Member PRO

The Webhooks Integration with WishList Member allows WishList Member to send (outgoing) data when certain events occur in WishList Member and trigger actions when data is received (incoming) from external sources.

Table of Contents

Enabling Webhooks Integration with WishList Member Integration

  1. Go to Setup > Integrations > Other Services > WebHooks.
  2. Enable the WebHooks integration by turning the toggle switch on.

Incoming WebHooks

Incoming WebHooks can be configured under the “Incoming” tab.

It allows external applications to add, remove, cancel and uncancel a user to/from membership levels and pay per posts in WishList Member via HTTP Posts sent to the URLs provided by WishList Member.

Furthermore, user account will be created if it doesn’t exist yet.

Creating Incoming WebHooks

  1. Click “Link New WebHook”.
  2. Enter a name for your WebHook under the “Settings” tab.
Webhooks Integration with WishList Member
  1. Configure under the “Actions” tab. See Actions for more info.
Webhooks Integration with WishList Member
  1. You may also configure the “field names” under the “Data Mapping” tab if the fields do not match WishList Member’s default field names. See Data Mapping for more info.
Webhooks Integration with WishList Member
  1. Click “Save” or “Save & Close”.
  2. You may now use the auto-generated URL for your incoming webhook to trigger actions in WishList Member.

See Sample cURL Request for a technical example.

Actions

Incoming WebHooks allows you to trigger 4 actions in WishList Member.

  1. Add To
  2. Remove From
  3. Cancel From
  4. Uncancel From

Add To

This action adds a user to:

  • Membership Levels
  • Pay Per Posts

Remove From

This action removes a user from:

  • Membership Levels
  • Pay Per Posts

Cancel From

This action cancels a user from:

  • Membership Levels

Uncancel From

This action uncancels a user from:

  • Membership Levels

Data Fields

By default WishList Member’s WebHooks integration accepts the following data fields:

Required Field:

  • email – Email address.

Optional Fields:

  • username – User’s username. Will be auto-created based on the configured “Username Format” if not specified.
  • password – User’s password. Will auto-generated if not specified.
  • firstname – User’s first name.
  • lastname – User’s last name.

Data Mapping

Should your application send data fields with different names, you may choose to map them under the “Data Mapping” tab.

Sample cURL Request

Request:

curl -X POST -d "[email protected]&firstname=John&lastname=Doe" {incoming-webhook-url}

Response:

{
    "success": 1,
    "code": 1
}

Outgoing WebHooks

Outgoing WebHooks can be configured under the “Outgoing” tab.

This allows the Webhooks Integration with WishList Member to send data to URLs your provided when a user is added, removed, cancelled and uncancelled to/from membership levels and pay per posts.

Configuring Outgoing WebHooks

  1. Choose a Membership Level or Pay Per Post to configure.
  2. This will open a modal box with 4 tabs, each representing an event.
  3. Choose the event that you wish to monitor and enter the URL or URLs (one URL per line) that you want the outgoing webhook data to be sent to
Webhooks Integration with WishList Member
  1. Click “Save” or “Save & Close”.

Events

Outgoing WebHooks allows you to monitor 4 events in WishList Member.

  1. When Added
  2. When Removed
  3. When Cancelled
  4. When Uncancelled

When Added

This event is fired when a user is added to:

  • Membership Levels
  • Pay Per Posts

When Removed

This event is fired when a user is removed from:

  • Membership Levels
  • Pay Per Posts

When Cancelled

This event is fired when a user is cancelled from:

  • Membership Levels

When Uncancelled

This event is fired when a user is uncancelled from:

  • Membership Levels

Outgoing WebHook Data

The following data are sent to the Outgoing WebHook URL(s)

  • trigger (string) Triggered event. Can be one of “add”, “remove”, “cancel”, “uncancel”
  • trigger_levels (array) Array of Level and Pay Per Post IDs that triggered the event.
  • id (integer) User ID
  • email (string) User Email
  • login (string) User Login (aka Username)
  • firstname (string) First Name
  • lastname (string) Last Name
  • nicename (string) Nice Name
  • display_name (string) Display Name
  • levels (array) Array of membership level objects assigned to the user keyed by the membership level ID.
  • pay_per_posts (array) Post IDs of the Pay Per Posts that the user has access to grouped by post type.

Sample Data:

{
  "trigger": "add",
  "trigger_levels": [
    "payperpost-1"
  ],
  "id": "1234",
  "email": "[email protected]",
  "login": "[email protected]",
  "firstname": "John",
  "lastname": "Doe",
  "nicename": "ema-il",
  "display_name": "John Doe",
  "levels": {
    "1650533556": {
      "Level_ID": "1650533556",
      "Name": "Alpha",
      "Timestamp": "1657204233",
      "Cancelled": 0,
      "CancelDate": 0,
      "CancelDateReason": "",
      "CancelledDate": 0,
      "Pending": 0,
      "UnConfirmed": 0,
      "Expired": 0,
      "ExpiryDate": 0,
      "SequentialCancelled": 0,
      "Scheduled": 0,
      "ParentLevel": 0,
      "Active": 1,
      "Status": [
          "Active"
      ],
      "TxnID": "WL-56-1650533556"
    },
  },
  "pay_per_posts": {
    "page": [
      2
    ],
    "post": [
      1
    ]
  }
}

Please feel free to reach out to our support team if you have any questions.

Was this article helpful?

Related Articles