Retently
The Retently modules allow you to monitor, create, update, list, and delete the customers, and survey responses in your Retently account.
Getting Started with Retently
Prerequisites
A Retently account
In order to use Retently with Make, it is necessary to have a Retently account. If you do not have one, you can create a Retently account at retently.com/integrations/.
Note
The module dialog fields that are displayed in bold (in the Make scenario, not in this documentation article) are mandatory!
To connect your Retently account to Make you need to obtain the API Key from your Retently account and insert it in the Create a connection dialog in the Make module.
1. Log in to your Retently account.
2. Click Settings icon.
3. Enter a name for the token and click Generate API Token.
![61f2789857ea1.gif](./../image/uuid-a7fb1bf5-142e-b110-954e-a1b459dc52a9.gif)
4. Copy the API Token to your clipboard.
![61f2789add24b.png](./../image/uuid-5043417e-885a-2336-8f34-817aea1f3374.png)
5. Go to Make and open the Retently module's Create a connection dialog.
![61f2789be2bc8.gif](./../image/uuid-9b633dd2-e7b9-a48d-97ba-f5f46bdde59e.gif)
6. In the Connection name field, enter a name for the connection.
7. In the API Key field, enter the API token copied in step 4 and click Continue.
The connection has been established.
List Customers
Returns a list of customers with specified fields.
Connection | |
Sort | Enter the option to filter the customers based on the specified option. For example, |
Limit | Set the maximum number of survey responses Make should return during one execution cycle. |
Create a Customer
Creates a customer.
Connection | |
Enter the customer's email address. | |
First Name | Enter the customer's first name. |
Last Name | Enter the customer's last name. |
Company Name | Enter the company with which the customer is working. |
Tags | Add the tags for the customer. |
Properties | Add the labels for the customer: Label Enter a name for the label. Type Select the label type. For example, Value Enter the value for the label. |
Update a Customer
Updates a customer.
Connection | |
Enter the customer's email address. | |
First Name | Enter the customer's first name. |
Last Name | Enter the customer's last name. |
Company Name | Enter the company with which the customer is working. |
Tags | Add the tags for the customer. |
Properties | Add the labels for the customer: Label Enter a name for the label. Type Select the label type. For example, Value Enter the value for the label. |
Delete a Customer
Deletes a customer.
Connection | |
Select or map the customer's email address you want to delete. |
Unsubscribe Customers
Unsubscribes customers.
Connection | |
Subscribers | Add the email addresses of the subscribers you want to unsubscribe. |
Message | Enter the reason text to notify the subscribers. |
Watch Survey Responses
Watches for survey responses.
Connection | |
Limit | Set the maximum number of survey responses Make should return during one execution cycle. |
Tag a Survey Response
Adds a tag to a survey response.
Connection | |
Response ID | Select the Response ID to which you want to add a tag. |
Tags | Add the tags with which you want to tag the response. |
Op | Select the override option, Append to append the tags to the response, or leave empty to override existing tags. |
Create Customers and Send Survey
Creates new customers or updates the existing ones and sends a transactional survey.
Connection | |||||||||||||
Campaign | Select or map the Campaign ID which you want to send to the customer. | ||||||||||||
Subscriber | Add the subscribers to send the survey:
|
Make an API Call
Performs an arbitrary authorized API call.
Connection | |
URL | Enter a path relative to NoteFor the list of available endpoints, refer to the Retently API Documentation. |
Method | Select the HTTP method you want to use: GET to retrieve information for an entry. POST to create a new entry. PUT to update/replace an existing entry. PATCH to make a partial entry update. DELETE to delete an entry. |
Headers | Enter the desired request headers. You don't have to add authorization headers; we already did that for you. |
Query String | Enter the request query string. |
Body | Enter the body content for your API call. |
Example of Use - List Campaigns
The following API call returns all the campaigns from your Retently account:
URL: /api/v2/nps/campaigns
Method: GET
![61f2789e21e66.png](./../image/uuid-d0eaf76e-465b-6d8c-a4cd-53a91314d5f4.png)
Matches of the search can be found in the module's Output under Bundle > Body. In our example, 2 campaigns were returned:
![61f2789f2b48d.png](./../image/uuid-98027ff9-2409-a7dc-bf80-4e2a2c25e7fd.png)