Account

Account settings

Method

Endpoint

Description

GET

Get email and SMS credit balance.

GET

Get the account contact fields filtered by fields' type

GET

Get the account emails sending profiles

GET

Get the account Sms sending profiles

GET

Check if the account has awaited merges.

GET

Get the account's ActiveCommerce integration data.

GET

Get the account's categories.

GET

Get a specific category details by providing its' ID.

PUT

Update a specific category details by providing its' ID.

Create a new category.

Delete a specific category by providing its' ID.

GET

Get executive reports.

GET

Get inactive and active contacts' daily growth filtered by dates (from/to date, the defualt is three months back)

Top

Automation Reports

Get reports of all your automation campaigns, divided into users who are currently logged in an automation journey and to users who completed a journey

Method

Endpoint

Description

GET

Returns all the contacts that started a specific automation and shows all their steps in the automation.

GET

Returns all the contacts that did not finish a specific automation

GET

Get SMS campaigns statistics for a specific automation.

GET

Get Whatsapp campaigns statistics for a specific automation.

GET

Get Push Notification campaigns statistics for a specific automation.

GET

Returns a summary report for a specific automation

GET

Returns email campaigns' summary reports in a specific automation

GET

Returns SMS campaigns' summary reports in a specific automation

GET

Returns the contacts that started a specific automation.

GET

Returns the contacts that finished a specific automation

Top

Automations

All the automation options are available to you here; create, edit, design, create triggers and send automated campaigns

Method

Endpoint

Description

GET

Get an automation information by its' id

Delete the given automation. You can delete a few in a bulk if the IDs are seperated with a comma (',')

GET

Get trigger's information of a specific "contact celebrates a date" automation. Providing an automation id that has a different trigger will result in an error.

GET

Get a specific automation's trigger information

GET

Get the details (excluding the steps) of a specific automation

PUT

Update the setup of the given automation

GET

Get the JSON that represents the design of the automation flow in the UI(excluding automation's steps)

GET

Get the JSON that represents the design of the automation flow in the UI including the data of the given automation

GET

Get the automation's steps flow

GET

Get a certain automation step information in the given automation

GET

Get all the 'send email' steps in a given automation

GET

Get the information of a specific email step in the given automation

PUT

Update an email campaign step in a given automation

GET

Get all the 'send SMS' steps in a given automation

GET

Get the information of a specific SMS step in the given automation

PUT

Update an SMS campaign step in the automation

GET

Get the information of a specific Whatsapp step in the given automation

GET

Get the information of a specific push notification step in the given automation

GET

Get the information of a specific 'contact update' step in the given automation

GET

Get the information of a specific Social step in the given automation

GET

Get the information of a specific A/B split step in the given automation

GET

Get the information of a specific 'notify someone' step in the given automation

GET

Get the activation status of the given automation

PUT

Activate/de-activate a given automation

GET

Get all the types of actions that can be updated for a contact in an automation

Send test campaigns from the given automation

Top

Automation triggers

Get all the options for start triggers

Method

Endpoint

Description

GET

Get all the start trigger options for automations

Top

Campaigns

Create, edit, design, delete, schedule and send email campaigns

Method

Endpoint

Description

GET

Get account's email campaigns. You can get campaigns filtered by various parameters including date and limited to a number of campaigns (you will get camapigns that were last updated in the last 3 months by default)

GET

Get campaign by id

Create and return a new campaign for specific groups. The campaign can be set as an A/B split, E-commerc or a regular campaign. Don't worry, we symplified it for you on our postman collection

PUT

Update a given campaign. Please note: only campaigns that are in a draft mode can be updated.

GET

Get campaign details

PUT

Update campaign details. Please note: only campaigns that are in draft mode can be updated

GET

Get campaign template

PUT

Update campaign template. Please note: only campaigns that are in draft mode can be updated

GET

Get campaign design

PUT

Update campaign design. Please note: only campaigns that are in draft mode can be updated

GET

Get campaign sending settings (groups and sending restrictions).

PUT

Update campaign sending settings (groups and sending restrictions). Please note: only campaigns that are in draft mode can be updated

GET

Get campaign schedule

PUT

Update campaign schedule. Please note: only campaigns that are in draft mode can be updated

GET

Return a list of sent campaigns

Create and return a new campaign for specific contacts. The campaign can be set as an A/B split, E-commerc or a regular campaign. Don't worry, we symplified it for you on our postman collection

Top

Campaign Reports

View your campaign reports, get a comparison report, get open rates, CTO rates, unsubcscribe rates and activity report

Method

Endpoint

Description

GET

Get a full report of your campaigns that include: send date, opens, clicks, CTO, bounces, unsubscribers, complaints, unopened and sent emails. You can get campaigns filtered by date and limited to a number of campaigns (you will get the reports of camapigns that were last updated in the last 3 months by default)

GET

Get an overview report for a specific campaign. You can limit the search to specific time (by default, the search will be for campaigns that were updated in the last 3 months. Please note: if the campaign you are searching for wasn't sent in the given dates - you'll get an error)

GET

Get a click report for a specific campaign. You can limit the search to specific time (by default, the search will be for campaigns that were updated in the last 3 months. Please note: if the campaign you are searching for wasn't sent in the given dates - you'll get an error)

GET

Get a specific link clickdetails. You can limit the search to specific time (by default, the search will be for campaigns that were updated in the last 3 months. Please note: if the campaign you are searching for wasn't sent in the given dates - you'll get an error)

GET

Get all the contacts that unsubscribed in a specific email. You can limit the search to specific time (by default, the search will be for campaigns that were updated in the last 3 months. Please note: if the campaign you are searching for wasn't sent in the given dates - you'll get an empty list)

GET

Get all contacts' activity on a specific campaign. You can limit the search to specific time (by default, the search will be for campaigns that were updated in the last 3 months. Please note: if the campaign you are searching for wasn't sent in the given dates - you'll get an error)

GET

Get campaign openers. You can choose to get all the openers from a specific group. You can limit the search to specific time (by default, the search will be for campaigns that were updated in the last 3 months. Please note: if the campaign you are searching for wasn't sent in the given dates - you'll get an empty list)

GET

Get campaign sent emails. You can choose to get all the openers from a specific group. You can limit the search to specific time (by default, the search will be for campaigns that were updated in the last 3 months. Please note: if the campaign you are searching for wasn't sent in the given dates - you'll get an empty list)

GET

Get contacts that didn't open a specific campaign. You can choose to get all the contacts that didn't open from a specific group. You can limit the search to specific time (by default, the search will be for campaigns that were updated in the last 3 months. Please note: if the campaign you are searching for wasn't sent in the given dates - you'll get an empty list)

GET

Get contacts that reported a specific campaign as "spam". You can choose to get all the complaints from a specific group. You can limit the search to specific time (by default, the search will be for campaigns that were updated in the last 3 months. Please note: if the campaign you are searching for wasn't sent in the given dates - you'll get an empty list)

GET

Get campaign's bounces and quantity of bounces per domain. You can limit the search to specific time (by default, the search will be for campaigns that were updated in the last 3 months. Please note: if the campaign you are searching for wasn't sent in the given dates - you'll get an empty list)

GET

Get a specific campaign's bounces by bounce type.

GET

Get a specific campaign's overview reports per domain.

GET

Get a specific campaign browser clients statistics

Top

Campaign Templates

Access to templates that are saved in your account under 'My Templates'. You can get all the templates, get specific template by id or create a new template and save it to 'My Templates'. You also have functions to get thet HTML of the saved template seperately from the template itself.

Method

Endpoint

Description

GET

Get account's "my templates"

GET

Get a specific template' information

Create and return a new template.

PUT

Update a specific template

Delete a specific template.

GET

Get a template's content

PUT

Update template's content.

Create campaign using a specific template

GET

Get "my templates" categories

Create and return a new template category.

PUT

Update the given template category

Delete the given template category. please note: if you delete a category - all the templates in this category will be deleted as well

Top

Commerce

Method

Endpoint

Description

PUT

Modify existing order

GET

Get order by its id.

Top

Contacts

Manage your contacts and subscriptions in this section, get all the contacts' details, create and remove contacts.

Method

Endpoint

Description

GET

Get account's contacts list. You can get the list filtered by customer status (active, unsubscribed, bounced. etc.,) by the state change date (from/to date, the defualt is three months back)

GET

Get contact details by contact id

Create and return a new contact. Please note: if the contact does not exist in the account they will be added but won't be linked to any group - maing it impossible to send him email/sms.

Import contacts to a group. Limited to 1000 contacts per call.

PUT

Update contact details

Delete the given Contact

GET

Get contacts in merge conflict You can get the list filtered by conflict status (active, inactive, deleted, etc.) by the conflict's occurrence date (from/to date, the defualt is three months back) and limited to a number of conflicts

GET

Get a specific merge conflict information

PUT

Resolve the given conflict

Delete a merge conflict

GET

Get contact's groups

GET

Get contact's activity on any email that was sent to them

GET

Get contact's bounces

GET

Get contacts' status and the source of their status (if known). You can filter the endpoint by contacts' creation date (from/to date, the defualt is three months back)

GET

Get all unsubscribers and the source of their status (if known). You can choose to get all unsubscription between specific dates (from/to date, the defualt is three months back)

GET

Get all subscribers and the source of their status (if known). You can choose to get all subscriptions between specific dates (from/to date, the defualt is three months back)

GET

Get statistics of contacts' statuses from specific dates. You can choose to get statistics between specific dates (from/to date, the defualt is three months back)

GET

Gets all contacts that are unsubscribed from getting sms messages

GET

Gets contact's statistics for specific campaign

GET

Gets customer statistics for specific operation message

GET

Gets contact's statistics for specific sms operational message.

GET

Get contact's mailing lists

Top

Web hooks

Define the parameters and the URLs of the following webhooks events: manually updating the contact info in the ActiveTrail app and updating the contact info programmatically via forms/import etc.

Method

Endpoint

Description

GET

Get the Webhook of a given id

Create a new Webhook

PUT

Update a Webhook

Delete a Webhook by a given id

GET

Get the Webhook Parameters for a given webhook id

PUT

Update a given Webhook Parameter

Delete a given Webhook Parameter

Send a test request for a given Webhook

Send a test request with a given url and parameters

Top

External

Method

Endpoint

Description

GET

Get contact by the external id and name. if one doesnt match the other we'll get an empty response.

GET

Get the contact list. You can get the list filtered by customer email and/or sms

GET

Get the list of unmapped contacts (those that have no external id or external name). You can get the list filtered by customer status (active, unsubscribed, bounced. etc.,) by the registration date (from/to date, the default is three months back) and limited to a number of contacts (the default is 100 contacts each time)

Import contacts. Limited to 1000 contacts. If the external ID you try to import exists - you'll get an error

Map external id and external name to unmapped contact

Unmap contact's external id and name based on the provided details. If one doesnt match the other or doesn't exist you'll get an error

Delete the given contact by providing external id and external name. If one doesnt match the other or doesn't exist we'll get an error

Add contact to group with the given external id and external name. Limited to 1000 contacts per call.

Add contact to mailing list with the given external id and external name. Limited to 1000 contacts per call.

Delete contacts from group with the given external id and external name

Delete contacts from mailing list with the given external id and external name

Create and send a new operational message

Create and send a new operational sms message

GET

Get contact's fields information

GET

Get the list of contacts activities. You can get the list filtered by the status changed date (from/to date, the default is three months back) and limited to a number of contacts (the default is 100 contacts each time)

Top

Groups

Manage groups on your account. View/ Create/ Update / delete groups, add or remove contacts

Method

Endpoint

Description

GET

Get group information by id

Create and return a new Group.

PUT

Update a given group

Delete a given group

GET

Get all group members. You can get the list filtered by customer status (active, unsubscribed, bounced. etc.,) by the state change date (from/to date, the defualt is three months back)

Add contact to a specific group. You can set the contact's status. please note: you cannot import a contact in status subscribe if he is inactive on ActiveTrail

Remove member from a group

Top

Mailing List

Manage mailing list on your account. View/ Create/ Update / delete mailing list, add or remove contacts

Method

Endpoint

Description

GET

Get account's mailing lists

GET

Get MailingList by id

Create and return a new Mailing List.

Delete MailingList

GET

Get all mailing list's members. You can get the list filtered by customer status (active, unsubscribed, bounced. etc.,) by the state change date (from/to date, the defualt is three months back)

Add a member to a mailing list

Remove member from mailing list

Top

Operational Message

Method

Endpoint

Description

Send an email operational message to individual emails (limited to 500 messages). The emails will be created as contacts in your account.

Send an email operational message to individual contacts (limited to 500 messages). The contacts will be created in your account.

Top

Push Campaign

Get your Push notifications campaign

Push Campaign Report

Push Notifications campaigns reports

Method

Endpoint

Description

GET

Get Push campaigns reports . You can get Push campaigns reports filtered (you will get the last 20 campaigns in the last 3 months by default)

GET

Getting the Overview report info of a specific Push campaign.

GET

Getting the sent report (contacts the campaign was sent to) of a specific Push campaign. The campaign must be sent in the time range you set using "from date" and "to date". (defauly is the last 3 months)

GET

Getting the delivered report (contacts the campaign was delivered to) of a specific Push campaign. The campaign must be sent in the time range you set using "from date" and "to date". (defauly is the last 3 months)

GET

Getting the failed report (contacts the campaign was sent to but got a delivery failure) of a specific Push campaign. The campaign must be sent in the time range you set using "from date" and "to date". (defauly is the last 3 months)

GET

Getting the opens report (contacts that opened a campaign) of a specific Push campaign. The campaign must be sent in the time range you set using "from date" and "to date". (defauly is the last 3 months)

Top

Automations' Segmentations

All automation segmentation options are available to you here such as: create and edit

Method

Endpoint

Description

GET

Get list of all user's segmentations

Create a new segmentation

PUT

Update the given segmentation

GET

Get dictionary of rules field types

GET

Get dictionary of rules field types

GET

Get dictionary of rules operations

GET

Get a full mapping of operations and field types associated to the type of rule.

Top

SignupForms

View the details of your sign up forms

Method

Endpoint

Description

GET

Get sign-up form by id

GET

Get all your sign-up forms

GET

Get account's landing pages

Top

Smart Code Site

Method

Endpoint

Description

GET

Get a list of the account's Smart Code sites

Create a new Smart Code site

PUT

Updates the exisiting Samrt Code site by site id

Delete a given smart Code site

Top

SMS Campaign

Create, edit, design, delete, schedule and send sms campaigns

Method

Endpoint

Description

GET

Get account's sms campaigns (including operational sms). You can get campaigns filtered by various parameters including dates and limited to a number of campaigns (you will get camapigns that were last updated in the last 3 months by default)

GET

Get SMS campaign by id

PUT

Update SMS campaign (whether it was sent or not). You can also sent the updated campaign in the process

Create and return a new SMS campaign

GET

Calculating the estimated number of messages for a given campaign. Can be used only for campaigns that were not sent yet

PUT

Update operational SMS messages. Only those who were not sent can be updated

Create and return a new operational SMS message

Top

SMS Campaign Report

sms campaigns reports

Method

Endpoint

Description

GET

Get SMS campaigns reports . You can get campaigns filtered by various parameters including dates and limited to a number of campaigns (you will get camapigns that were last updated in the last 3 months by default)

GET

Get SMS campaigns reports . You can get campaigns filtered by various parameters including dates and limited to a number of campaigns (you will get camapigns that were last updated in the last 3 months by default)

GET

Get a specific SMS campaign summary report

GET

Get all the contacts that the sms was sent to. If you didn't send the sms to a group but chose the "add numbers manually" function - you'll get the amount of contacts the sms was sent to but not the numbers. You can also filter by dates. (the search for the campaign will be made, by default, in the last 3 months. If the campaign wasnt sent in the given range - you will get no information)

GET

Get all the contacts that the sms was delivered to. If you didn't send the sms to a group but chose the "add numbers manually" function - you'll get the amount of contacts the sms was sent to but not the numbers. You can also filter by dates. (the search for the campaign will be made, by default, in the last 3 months. If the campaign wasnt sent in the given range - you will get no information)

GET

Get all the contacts that clicked on a link sms (can be filtered by specific link). If you didn't send the sms to a group but chose the "add numbers manually" function - you'll get the amount of clickers but not the mobile numbers. You can also filter by dates. (the search for the campaign will be made, by default, in the last 3 months. If the campaign wasnt sent in the given range - you will get no information)

GET

Get clickers by link id. If you didn't send the sms to a group but chose the "add numbers manually" function - you'll get the amount of clickers but not the mobile numbers. You can also filter by dates. (the search for the campaign will be made, by default, in the last 3 months. If the campaign wasnt sent in the given range - you will get an error)

GET

Get all the contacts that the sms wasn't sent to (delivery failure). If you didn't send the sms to a group but chose the "add numbers manually" function - you'll get the amount of clickers but not the mobile numbers. You can also filter by dates. (the search for the campaign will be made, by default, in the last 3 months. If the campaign wasnt sent in the given range - you will get no information)

GET

Get all the contacts that unsubscribed from a specific campaign sms. If you didn't send the sms to a group but chose the "add numbers manually" function - you'll get the amount of clickers but not the mobile numbers. You can also filter by dates. (the search for the campaign will be made, by default, in the last 3 months. If the campaign wasnt sent in the given range - you will get no information)

Top

User Social

Get all the options for start triggers

Method

Endpoint

Description

GET

Get account's social

Top

Two Way Sms

Create, edit, design, delete, schedule and send sms campaigns