Assign lists to user action

This action lets you assign one or multiple lists to a user via the Autonami integration. Use it to automate you daily work and save time and resources.

Visit the Autonami integration

How to assign one or multiple lists to a user

This section aims to help you getting started on how to assign one or multiple lists to a user via Autonami. Simply select one of your prefered automation manuals down below and start automating your WordPress website in no time.

How to set up an automation workflow

This manual will demonstrate you on how to use the Flows feature of WP Webhooks to create an automation workflow (with multiple actions) directly on your WordPress website in combination with the Assign lists to user action.

To get started, we will walk you through each step from the beginning to the end so that you can make sure your endpoint will work as expected.

Required plugins/services

In order to use this webhook action, you need to make sure you installed and activated the following plugins, or have an active account with the given service:

1. Setup a Flow

To get started, please login into your WordPress website, navigate to your WordPress dashboard > WP Webhooks > Flows and open/create a Flow of your choice. If everything is ready, please follow the steps down below:

Add a trigger of your choice, configure it and continue the process. If you are unsure about how to do that, feel free to check out this manual.
If you plan on connecting this trigger with other services such as Zapier, Make (Integromat), IFTTT, Zoho Flows, etc. You can select those integrations from the trigger dropdown. If you want to learn more about our third-party integrations, feel free to take a look at our third-party integration page.

2. Add and configure the action

Add a new action within the Flow, select the Autonami integration, and choose the Assign lists to user action.
After you selected the action as described above, it is time to configure the settings. If you don't feel completely familar with the layout of the Flow, you can read more about the basic setup of a Flow via the following helpfile.
Within those "Action Settings", you will see a list of all available arguments for the Assign lists to user action and further information about what the argument is about.
As seen in the example screenshot above, you can add multiple arguments. Each of those arguments has a different purpose and allows you to customize the data that will be sent. To see a full list, simply scroll down on this page to the argument list.
After that's done, simply continue the Flow action and test it. If everything works fine, you will get a successful response from the webhok call and everything was set up correctly. Within this Flow, you can also use all of the response values from the action call as parameters within the following actions.
Set the Flow status to active and save the flow.
In case of an error, please check its message for further information. We do also maintain a list of common error which you will find here.

3. Summary

If you followed all the steps above, your Flow will now send data based on its given trigger to the Assign lists to user action with the custom arguments you set up.
In case you want to learn more about this setup and others, please visit our documentation.

How to set up a direct connection (Advanced)

This manual will demonstrate you on how to set up a direct connection between the Assign lists to user action (to receive data) and your chosen service (to send data to this action).

To get started, we will walk you through each step from the beginning to the end so that you can make sure your endpoint will work as expected.

Required plugins/services

In order to use this webhook action within a direct connection, you need to make sure you installed and activated the following plugins, and/or have a valid account with the given service:

1. Setup WP Webhooks

To get started with WP Webhooks, simply download the latest version from your account dashboard and install/activate it on your WordPress website. If you want to lean more about the installation process of the plugin itself, please check out this manual.

2. Integrate the action with your service

In order to send data from your service to the Assign lists to user action, you need to provide an URL to your service so that it can send information over to WP Webhooks.
As we provide automatically such receiving webhook URLs, you can simply copy it from within WP Webhooks.

Please head over to your WordPress dashboard > WP Webhooks > Receive Data > Assign lists to user and create/copy a webhook URL of your choice.
Once you copied the URL, please locate the possibility to send data within your external service (this could be a webhook endpoint, API integration, etc.), or an automation service such as Zapier, Make (Integromat), Zoho Flows, n8n, etc (Click here to see a list of all available third-party integrations).
After that, you can add the copied URL from the "Receive Data" tab into the specified field of your service.

What we have accomplished so far: At this stage, your external service is already able to send data to your WordPress website via the previously generated URL. By default, our plugin can detect (and accepts) various Content-Types such as JSON and XML. We also suggest sending the requests as a POST request.

3. Set up Data Mapping

While the above connection can aleady transer data from your service to the Assign lists to user action, it won't do much as in most cases the data sent from your service has a different format than what WP Webhooks requires.
To solve that, we offer a feature called Data Mapping. This allows you to automatically alter and map the incoming data from your service to map its values to the required arguments from WP Webhooks.
This feature allows you to do various mapping possibilities, create new values and manipulate existing ones. To show you this feature in a practical way, down below is a short manual on how you can set up the data mapping template:

Set up a Data Mapping template

Go to your WordPress dashboard > Settings > WP Webhooks > Data Mapping and add a new Data Mapping template.
Within it, you can add your mapping data that adjusts the data sent by your service to the arguments required by WP Webhooks.
Lastly, you need to connect the Data Mapping template to the receiving URL you selected in step 1 (Setup your Webhooks). To do that, please head over to your WordPress dashboard > WP Webhooks > Receive Data and open the Setting of the specific webhook URL. There you will find a setting called Add request data mapping template - simply select your your Data Mapping template from the dropdown and save it.
That's it. Now all data sent from your service will be validated by the data mapping template. To learn more about it, please check out our documentation for Data Mapping templates.

Configure the Data Mapping template
Now it is up to you what data you want to send in wich way to the Assign lists to user action. As for most of our actions, we offer something called Arguments which are similar to variables that you can use to assign data to a purpose.
Below this box you will find a list of all available action arguments for the Assign lists to user action. Click here to jump direclty to it.

Go to your WordPress dashboard > WP Webhooks > Data Mapping and open the data mapping template you created in the previous step.
Within it, you can create your mapping based on the arguments from the argument list. Once you add a new row, you can add the argument into the left field.
On the right you can add keys to map the data based on the data that was sent by your service. To learn more about the mapping, please check out this helpfile.

Down below you will find a data mapping template example that shows a simple configuration on how to use it to manipulate values.

{"template_settings":{"wpwhpro_data_mapping_whitelist_payload":"none"},"template_data":[{"new_key":"static_first_name","singles":["{\"settings\":{\"wpwhpro_data_mapping_value_type\":\"data_value\",\"wpwhpro_data_mapping_convert_data\":\"none\",\"wpwhpro_data_mapping_decode_data\":\"none\",\"wpwhpro_data_mapping_fallback_value\":\"\"},\"value\":\"Jon\"}"]},{"new_key":"static_last_name","singles":["{\"settings\":{\"wpwhpro_data_mapping_value_type\":\"data_value\",\"wpwhpro_data_mapping_convert_data\":\"none\",\"wpwhpro_data_mapping_decode_data\":\"none\",\"wpwhpro_data_mapping_fallback_value\":\"\"},\"value\":\"Doe\"}"]},{"new_key":"full_name","singles":["{\"settings\":{\"wpwhpro_data_mapping_value_type\":\"data_value\",\"wpwhpro_data_mapping_convert_data\":\"none\",\"wpwhpro_data_mapping_decode_data\":\"none\",\"wpwhpro_data_mapping_fallback_value\":\"\"},\"value\":\"{:static_first_name:} {:static_last_name:}\"}"]},{"new_key":"mapped_first_name","singles":["{\"settings\":{\"wpwhpro_data_mapping_value_type\":\"key_mapping\",\"wpwhpro_data_mapping_convert_data\":\"none\",\"wpwhpro_data_mapping_decode_data\":\"none\",\"wpwhpro_data_mapping_fallback_value\":\"\"},\"value\":\"static_first_name\"}"]}]}

After the import, simply save the template. From there, you can head over to the preview (via the Preview template button) and see how the data mapping template is adjusting the data from the left side (which is the incoming data) to the mapped data (on the right).
Lastly, you only need to map the values sent by your service to the arguments available for this action.
If you are unsure about the format the data is sent from your service, you have various options:
- One possibility is to check the documentation of your service as they often document their payloads
- If your payload is not documented, you can also use our Log feature. Once you sent a request from your service to the webhook URL, you will see an entry within the logs, including the data.
- You can also send the data to a different webhook URL such as the one generated by https://webhook.site/.

4. Summary

If you followed the steps above, you successfully set up your webhook connection and connected the data mapping template. This is everything you need to automatically send data from your external service to the Assign lists to user action.
In case you want to learn more about this setup and others, please visit our documentation.

"Assign lists to user" arguments

Our so-called arguments are values that you can use to customize your request. They allow you to send specific data to the Assign lists to user action which is then handled accordingly to the described purpose. You can use the arguments that you would like to send values for.
To learn more about it, please see the Setup Guide above.

user *

(Mixed) The user ID or user email of the user you want to assign lists to.

lists *

(Array) The list slugs you want to add to the user. You only have to choose existing lists. This argument expects a JSON formatted string with the list slugs as a value.

wpwh_call_action

(String) Register a custom WordPress hook callback. The value will be called as followed: do_action( $yourdefinedaction, $action_return_data, $request_data )

Connection examples

Get inspired on how to use the "Assign lists to user" action within our Autonami integrations. Down below you will find various examples with our other integrations.

When a free membership expired via

Restrict Content Pro, assign one or multiple lists to a user via

Autonami.

When a taxonomy term was deleted via

WordPress, assign one or multiple lists to a user via

Autonami.

When a comment was deleted via

WordPress, assign one or multiple lists to a user via

Autonami.

When a booking was cancelled via

Events Manager, assign one or multiple lists to a user via

Autonami.

When a coupon was created via

WooCommerce, assign one or multiple lists to a user via

Autonami.

When a quiz was completed via

Tutor LMS, assign one or multiple lists to a user via

Autonami.

When a topic was created via

bbPress, assign one or multiple lists to a user via

Autonami.

When a contact was added to one or multiple lists via

Autonami, assign one or multiple lists to a user via

Autonami.

When a Microsoft Power Automate webhook request was received via

Microsoft Power Automate, assign one or multiple lists to a user via

Autonami.

When all the cache was cleared via

Breeze, assign one or multiple lists to a user via

Autonami.

When a profile photo was updated via

WP User Manager, assign one or multiple lists to a user via

Autonami.

When the CSS/JS cache was cleared via

LiteSpeed Cache, assign one or multiple lists to a user via

Autonami.

When a coupon was updated via

WooCommerce, assign one or multiple lists to a user via

Autonami.

When a IFTTT webhook request was received via

IFTTT, assign one or multiple lists to a user via

Autonami.

When a contact was removed from a tag via

FluentCRM, assign one or multiple lists to a user via

Autonami.

When a cover photo was removed via

WP User Manager, assign one or multiple lists to a user via

Autonami.

When a purchase was completed via

WP Simple Pay, assign one or multiple lists to a user via

Autonami.

When a free membership was activated via

Restrict Content Pro, assign one or multiple lists to a user via

Autonami.

When a paid membership was activated via

Restrict Content Pro, assign one or multiple lists to a user via

Autonami.

When an account was marked inactive via

Ultimate Member, assign one or multiple lists to a user via

Autonami.

When a donation was cancelled via

GiveWP, assign one or multiple lists to a user via

Autonami.

More available Autonami endpoints

Discover more of the available endpoints used for the Autonami integration.
To learn more about a specific endpoint, simply click on it.

Send Data (Triggers)	Receive Data (Actions)
Contact added to list Pro	Add new contact Pro
Contact removed from list Pro	Assign lists to contact Pro
Contact tags added Pro	Assign lists to user Pro Current
Contact tags removed Pro	Assign tags to contact Pro
	Assign tags to user Pro
	Get lists Pro
	Get tags Pro
	Remove contact from lists Pro
	Remove contact tags Pro
	Remove user from lists Pro
	Remove user tags Pro