FunnelKit Webhooks

#Overview

With FunnelKit Pro, you can use webhooks in automations to connect to WP Fusion installed on another site.

Using webhooks you can import new users on your WordPress site based on rules in FunnelKit, or update existing users’ meta data and tags.

For example, you could sell access to a course using WooCommerce and FunnelKit on Site A, and using a webhook, WP Fusion on Site B can automatically import the new customer and enroll them in the course they purchased.

Having trouble receiving webhooks? Check out our troubleshooting guide.

#Setup

Navigate to FunnelKit » Automations and create a new automation to handle the webhook. Select a trigger (such as a tag being applied), and click the Add Direct Action button to add a new action.

In the popup that appears, select Send Data, and then HTTP Request.

In the webhook settings, configure the webhook like in the screenshot below.

The settings should be:

  • Enter URL: This is the URL to the website where WP Fusion is installed.
  • Method: Either GET or POST, but sometimes POST requests get blocked by security plugins, so we recommend GET.
  • Data: At minimum you must have:
    • contact_id: {{contact_id}} (this tells WP Fusion which contact to import)
    • access_key: (the access key from the bottom of the General tab in the WP Fusion settings)
    • wpf_action: (see below for options)

#Webhook parameters

You can format your webhook parameters in a few different ways to customize the behavior. For each you will need to supply your access key, which can be obtained from the bottom of the main settings panel in your WP Fusion settings.

#To update a user’s tags

To update an existing WordPress user’s tags from the contact record, the data parameters should be

contact_id = {{contact_id}}
wpf_action = update_tags
access_key = [your access key]

#To update a user’s tags and meta data

To update a user’s tags and pull any new meta data from FunnelKit for that contact, the data parameters for the webhook should look like the following:

contact_id = {{contact_id}}
wpf_action = update
access_key = [your access key]

#Create a new user

To create a new user, use the following:

contact_id = {{contact_id}}
wpf_action = add
access_key = [your access key]

You can also specify additional parameters in user creation. For example, to send the user a welcome email containing a link to log in on your site, use the following:

contact_id = {{contact_id}}
wpf_action = update_tags
access_key = [your access key]
send_notification = true

You can also specify a specific user role to be assigned to the new user. For example, to set the new user to the “customer” role, use the following:

contact_id = {{contact_id}}
wpf_action = update_tags
access_key = [your access key]
role = customer

Note that you have to have registered a “customer” role on your site for this to work. By default users will be assigned the role of “subscriber”.

The add method will update a user if an existing user already exists. It will not create a duplicate user.

Note: By default, user accounts will be created with their email address as the username and a randomly generated password. However, if you have created a custom username field and password field in FunnelKit, and enabled these fields in WP Fusion for sync with user_login and user_pass on your website, the new users will be given the usernames and passwords stored in their FunnelKit contact record.

#User passwords

New user accounts will be created with an automatically generated password. If you’d like to use this password in your email marketing, you can send the password back to FunnelKit after it has been generated.

In the Webhooks section of the General settings tab, check the box for Return Password, and select a field in FunnelKit where the password should be stored.

After a new user is created, their automatically generated password will now be saved back to their contact record, and you can use a merge field to include it in an email. The username will be the contact’s email address.

Was this helpful?