• Instructions to Ask a Question

    Click on the "Ask a Question" button and select the application for which you would like to ask questions.

    We have 5 different products namely - Pabbly Connect, Pabbly Subscription Billing, Pabbly Email Marketing, Pabbly Form Builder, Pabbly Email Verification.

    The turnaround time is 24 hrs (Business Hours - 10.00 AM to 6.00 PM IST, Except Sunday). So your kind patience will be highly appreciated!

  • Important: Any reported problems and issues with your integration will be reported to you and we will encourage the app developers help to resolve those integration issues.

Configure Actions

Status
Not open for further replies.
Login to your Pabbly Connect account: https://accounts.pabbly.com/login.
In case, you don't have a Pabbly Connect account then, you can create one from here: https://accounts.pabbly.com/signup/
Once you have logged in to your Pabbly Connect account then, you can start building your app integration through this link: https://connect.pabbly.com/app

First, you need to Create an App along with the authentication methods as explained in this article: https://forum.pabbly.com/threads/app-details-and-auth-configuration.2426/

Once, you have configured the app details then, visit the Actions section by clicking the Actions on the left panel menu and you can create an action event(s) with basic details like Name, Description, Video Tutorial (if any) and API endpoint along with parameters.

2021-11-17_17h13_22.png


Action Name:
Simple and Short (The first letter of each word must be capital)​
Example: Update Contact

Action Description:
In a few words describe the functionality of the action/trigger. Write the description in third person and capitalize only the first letter of the first word in the description (like a normal sentence structure).​
Example: Description for the action Update Contact.​
Updates the contact details for a specified contact .
1634810830929.png

Action Event API Configuration with JSON Request Body Type -
  • HTTP request method - Specify an HTTP method to request this action event e.g. POST
  • API Endpoint URL - The URL to communicate with third-party applications using the HTTP request method in order to either push or receive data from them e.g. https://emails.pabbly.com/api/subscribers-list/create
  • Request Body Type - Specify a request body type to request this action event. By default, it is JSON.
  • Wrap in Array - Specify if your request raw JSON needs to be wrapped in an array or not.
  • HTTP Headers - API headers serve as an additional source of data for each API call you make. It is used to represent the meta-data that goes along with an API request.
  • Set Body/Query Parameters - Set parameters if this action event requires to pass the query/URL parameters or map in request raw JSON e.g. list_name.
  • Request Body (Raw JSON) - Select this if this action event requires to pass the raw JSON data. If used in endpoints then, all variables in it defined under Set parameters option should have required option opted. (Some API accepts blank values for JSON keys).
1635771038865.png

Action Event API Configuration with Form-Data Request Body Type -

If your app’s API requires content-type:application/x-www-form-urlencoded and you need to pass data query parameters. This request body type allows you to add more fields from workflow by clicking on plus button.
  • HTTP request method - Specify an HTTP method to request this action event e.g. POST
  • API Endpoint URL - The URL to communicate with third-party applications using the HTTP request method in order to either push or receive data from them e.g. https://emails.pabbly.com/api/subscribers-list/create
  • Request Body Type - Specify a request body type as Form-data to request this action event.
  • HTTP Headers - API headers serve as an additional source of data for each API call you make. It is used to represent the meta-data that goes along with an API request.
  • Set Body/Query Parameters - Set parameters if this action event requires passing the query/URL parameters. e.g. list_name.
1635771198480.png
Action Event API Configuration with XML Request Body Type -
  • HTTP request method - Specify an HTTP method to request this action event e.g. POST
  • API Endpoint URL - The URL to communicate with third-party applications using the HTTP request method in order to either push or receive data from them e.g. https://emails.pabbly.com/api/subscribers-list/create
  • Request Body Type - Specify a requested body type as XML to request this action event.
  • HTTP Headers - API headers serve as an additional source of data for each API call you make. It is used to represent the meta-data that goes along with an API request.
  • Set Body/Query Parameters - Set parameters if this action event requires passing the query/URL parameters. e.g. list_name.
1635771218768.png
Note: you can use parameters within double curly braces e.g. https://{{subdomain}}.example.com/api/v3/contacts?api-key={{api-key}} in the API Endpoint URL (if required)​
Refer to the below video for creating an action of your app:​

There are some cases for the Actions configuration which depends on the app's requirements as explained below:

Case 1 - If it is required to generate dropdown field values in the action event, you need to make use of the Inbuilt Action step just above the Action Event API Configuration section by clicking the plus (+) button.​
Now, select the available inbuilt action events from the dropdown field as shown below:​
1634811791475.png
Then, you can define the parameter key in the Dynamic Dropdown (Optional) option and you can configure that parameter key and value for the requested raw JSON as shown below:​
1635771448869.png
1635771317222.png
1634811847333.png
Case 2. Making an action compatible with Line Items (Optional).​
Find the JSON object key of the request body to dynamically build line item(s) objects e.g. items. You can read more about this from here: https://forum.pabbly.com/threads/ho...with-line-item-s-like-body-request-json.2566/
1634812108132.png
Then define the JSON object key of the request body to dynamically build line item(s) objects.​
1635844847670.png
Read more configuring actions compatible with Line Item(s) like Body Request JSON from here.​
Case 3. Configuring Request Body JSON of an Action with Dynamic/Custom Fields​
Custom fields of an application are the dynamic fields configured by the app users in their app dashboard. Many applications like MailChimp, Mailerlite, Pabbly Email Marketing etc. allows user to manage their contacts, lists, subscribers etc based on custom fields.​
You can read more about configuring the action with custom fields from here: https://forum.pabbly.com/threads/ho...of-an-action-with-dynamic-custom-fields.2577/
Case 4. Multi-step Action (if required to execute an inbuilt multi-step action after the action response.) you need to make use of the inbuilt multi-step action after the Action Event API Configuration section by clicking the plus (+Multi-step Action) button.​
Now, select the available inbuilt action events from the dropdown field as shown below:​
1634813163718.png
 

Attachments

  • 1634811299479.png
    1634811299479.png
    37.8 KB · Views: 60
  • 1634811324814.png
    1634811324814.png
    33 KB · Views: 58
  • 1634811340997.png
    1634811340997.png
    36.1 KB · Views: 52
  • 1634811816718.png
    1634811816718.png
    29.1 KB · Views: 52
  • 1634811834071.png
    1634811834071.png
    27.8 KB · Views: 51
  • 1634812120280.png
    1634812120280.png
    11.6 KB · Views: 59
  • 1634813122865.png
    1634813122865.png
    37.1 KB · Views: 49
  • 1635771237862.png
    1635771237862.png
    26.9 KB · Views: 33
  • 1635771285510.png
    1635771285510.png
    26.9 KB · Views: 34
Last edited:
Status
Not open for further replies.
Top