Endorsal

The Endorsal modules allow you to monitor, create, update, send, retrieve, list, archive, and delete the contacts, and testimonials in your Endorsal account.

Getting Started with Endorsal

Prerequisites

Note

The module dialog fields that are displayed in bold (in the Make scenario, not in this documentation article) are mandatory!

Connecting Endorsal to Make

To connect your Endorsal account to Make you need to obtain the API Key from your Endorsal account and insert it in the Create a connection dialog in the Make module.

  1. Log in to your Endorsal account.

  2. Click Your Profile Icon > API > Generate New API Key.

    61f26c0888506.gif
  3. Copy the API Key to your clipboard.

    61f26c0bc64f4.png
  4. Go to Make and open the Endorsal module's Create a connection dialog.

    61f26c0cda5b8.gif
  5. In the Connection name field, enter the connection name.

  6. In the API Key field, enter the API key copied in step 3 and click Continue.

The connection has been established.

Contacts

Retrieves a list of contacts.

Connection

Establish a connection to your Endorsal account.

Limit

Set the maximum number of contacts Make should return during one execution cycle. The default value is 10.

Creates a new contact.

Connection

Establish a connection to your Endorsal account.

Email

Enter (map) the contact's email address. For example, jane.doe@example.com.

Phone

Enter (map) the contact's phone number. For example, +1417261826123.

Name

Enter (map) the contact's name.

External ID

Enter (map) the contact's external ID of the platform from where the contact was imported. For example, abc123.

Imported From

Enter (map) the platform name from which the contact was imported.

Avatar

Enter (map) the URL address to the contact's profile image.

Location

Enter (map) the contact's location. For example, United Kingdom.

Position

Enter (map) the contact's job title in the company. For example, Founder.

Company

Enter (map) the contact's company name. For example, abc.

Website

Enter (map) the company's website URL address.

Property ID

Enter (map) the Property ID to which the contact belongs.

Custom Attributes

Add any additional attributes for the contact:

Key

Enter (map) the key name. For example, first name.

Value

Enter (map) the key value. For example, first name is xyz.

Retrieves a contact.

Connection

Establish a connection to your Endorsal account.

Contact ID

Select or map the Contact ID whose details you want to retrieve.

Updates a contact.

Connection

Establish a connection to your Endorsal account.

Contact ID

Select or map the Contact ID whose details you want to update.

Name

Enter (map) the contact's name.

Email

Enter (map) the contact's email address. For example, jane.doe@example.com.

Archives a contact.

Connection

Establish a connection to your Endorsal account.

Contact ID

Select or map the Contact ID you want to archive.

Testimonials

Triggers when a new testimonial has been created.

Connection

Establish a connection to your Endorsal account.

Limit

Set the maximum number of testimonials Make should return during one execution cycle. The default value is 20.

Retrieves a list of testimonials.

Connection

Establish a connection to your Endorsal account.

Limit

Set the maximum number of testimonials Make should return during one execution cycle. The default value is 10.

Creates a new testimonial.

Connection

Establish a connection to your Endorsal account.

Name

Enter (map) the testimonial name.

Comments

Enter (map) additional comments for the testimonial.

Property ID

Enter (map) the Property ID applicable to the testimonial.

Rating

Select or map the rating of the testimonial between one and five.

Avatar

Enter (map) the URL address of the contact's profile image.

Email

Enter (map) the contact's email address applicable to the testimonial. For example, jane.doe@example.com.

Location

Enter (map) the contact's location who has provided the testimonial. For example, United Kingdom.

Position

Enter (map) the contact position in the company. For example, Founder.

Company

Enter (map) the company name. For example, abc.

Approved

Select or map the testimonial approval status:

  • Approved

  • Unapproved

  • Rejected

Featured

Select whether the testimonial is featured on the company's website:

  • Featured

  • Not Featured

Added

Enter (map) the date the testimonial is added. See the list of supported date and time formats.

Retrieves a testimonial.

Connection

Establish a connection to your Endorsal account.

Testimonial ID

Select or map the Testimonial ID whose details you want to retrieve.

Updates a testimonial.

Connection

Establish a connection to your Endorsal account.

Testimonial ID

Select or map the Testimonial ID whose details you want to update.

Name

Enter (map) the testimonial name.

Comments

Enter (map) additional comments for the testimonial.

Property ID

Enter (map) the Property ID applicable to the testimonial.

Rating

Select or map the rating of the testimonial between one and five.

Avatar

Enter (map) the URL address of the contact's profile image.

Email

Enter (map) the contact's email address applicable to the testimonial. For example, jane.doe@example.com.

Location

Enter (map) the contact's location who has provided the testimonial. For example, United Kingdom.

Position

Enter (map) the contact position in the company. For example, Founder.

Company

Enter (map) the company name. For example, abc.

Approved

Select or map the testimonial approval status:

  • Approved

  • Unapproved

  • Rejected

Featured

Select whether the testimonial is featured on the company's website:

  • Featured

  • Not Featured

Added

Enter (map) the date the testimonial is added. See the list of supported date and time formats.

Deletes a testimonial.

Connection

Establish a connection to your Endorsal account.

Testimonial ID

Select or map the Testimonial ID you want to delete.

Other

Performs an arbitrary authorized API call.

Connection

Establish a connection to your Endorsal account.

URL

Enter a path relative to https://api.endorsal.io For example: /v1/contacts

Note

For the list of available endpoints, refer to the Endorsal 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.

The following API call returns all the testimonials from your Endorsal account:

URL:

/v1/testimonials

Method:

GET

61f26c0f566f0.png

Matches of the search can be found in the module's Output under Bundle > Body > data.

In our example, 3 testimonials were returned:

61f26c107d23d.png