Connectors / Service / Outreach

Artisan IMG > Outreach (outreach)

Outreach

Make your team's communication workflows faster, and reveal the performance insights that make them more effective at selling - all in one system.

Overview

The Outreach connector enables the full manipulation of data within the Outreach Sales Engagement Platform, including Accounts, Opportunities, Calls, Prospects and Mailings.

Note

If you are wanting to return collections of data that have a total count greater than 10,000, it will cause the Outreach API to crash. When dealing with large collections of Outreach data, be sure to break down the collection into smaller chunks to ensure that API doesn't crash when the 10,000 count limit is reached - source.

Authentication

To use the Outreach connector, simply use the same credentials you would use to login to your Outreach account. To add a set of credentials to login to your Outreach account, navigate to the workflow where you wish to use the Outreach connector and click on new authentication.

add-auth

When you log in with your credentials through the Tray.io platform, you are granting permission for Tray.io to access you Outreach account. It is possible to grant access to specific data objects in Outreach, rather than granting access to all data.

To include certain data objects, such as Prospects, Mailings and Accounts, tick the box under the chosen object type in the pop up window. .all refers to the permissions on that data object, which include read and write (and delete).

outreach-scopes

Click on the next button to enter your credentials and grant permission to the Tray.io app.

Example 1 - Creating a record in Outreach

Step 1 - Attributes and relationships

In this example, we'll be creating an account in Outreach. The format of the input property panel is usually split into two high level sections, attributes and relationships. Attributes describe the record being created. In the relationship properties, the IDs of other records you want to relate to the new record can be entered.

Attributes and Relationships are specified in a similar way for all Create operations. The types of records that can be related will be listed.

Start off by dragging the Outreach connector to a workflow and selecting Create account from the operation dropdown.

outreach-example1.1

outreach-example1.2

Step 2 - Enter attribute details

When creating a record in Outreach, all required attribute must be completed. Any property with * next to the name is required.

outreach-example1.3

Step 3 - Specify relationships

The next step in creating an account is relating the account to an Owner (this could be, for example, an account manager) who will look after that account. It is worth noting that other record types, for example a mailing record, will have more options for relationships (see a screenshot below of the relationships when creating a mailing record)

outreach-example1.4

Step 4 - Specify custom fields

In Outreach, some of the record types allow for custom fields to be specified. Where custom fields do exist, a list of custom field properties will be present in the input property panel.

If custom fields have been labelled in Outreach, you may have to refer to your Outreach admin to find out which number corresponds to which custom field.

Please note that the order is the same i.e. if custom fields in the Outreach UI appeared as Test 1, Test 2, etc, then Test 2 would correspond to Custom 2 in the Outreach connector input property panel.

outreach-example1.5

Step 5 - Working with output

All create operations when successful return the record just created. The format of records returned consistently has everything falling under a data property, which the type property specifying the type record e.g. account, prospect, opportunity, etc.

docs-outreach-example1.6.png

Also falling under the data property are the attributes and relationships properties. Under the attributes, all the values entered in the input property panel should be seen.

The relationship properties returns a number of relationships, both specifying actual IDs of related records and also links to related lists of records. These links could potentially be used by the HTTP Client connector to obtain details for these related records.

outreach-example1.7

Example 2 - Listing records

Step 1 - Choose list criteria

Most of the List operations in the Outreach connector have some filtering and sorting functionality.

Results of the list operation can be filtered by particular fields on the record. For example, when listing opportunities, results can be filtered by a range of values in the field Amount.

outreach-example2.1

Step 2 - Specify list sorting

Lists can be sorted by particular fields. Each record or object type has different sortable fields, please refer to this link to find out more information about which fields can be sorted by.

outreach-example2.2

Step 3 - Specify pagination

If dealing with large amounts of data, you may not want to deal with all the data in one go. The answer to this would be to limit the number of results and specify a page. Please be aware that the max number of items that can be returned by list functions is 50 per page.

outreach-example2.3

Outreach trigger

The Outreach trigger allows you to receive notifications and trigger workflows when given events occur associated with a given entity. A workflow can listen for when entities are created, deleted, updated or all types of events. You can then specify one of the following entities to listen to:

  • All

  • Prospect

  • Opportunity

  • Task

  • Call

  • Sequence

  • User

  • Account

  • Mailbox

  • Sequence step

  • Sequence state

  • Mailing

Below is an example of how to use the outreach trigger:

Step 1 - Select the Outreach trigger found in the trigger listings

When creating a workflow, select the Outreach trigger in the listings. This will load up the workflow with the Outreach trigger waiting for you.

select-trigger

Step 2 - Select / create an authentication

Before being able to configure the trigger, an authentication will need to be provided. Either select a pre-existing one or create one (see Authentication section).

Step 3 - Select an action

The first step in configuring when your workflow will be notified is selecting what action should be listened to. Select one from the dropdown.

select-action

Step 4 - Select an entity

The second step in configuring when your workflow will be notified is selecting what entity will be listened to for changes that have been defined in the previous step.

select-entity

Step 5 - Enable workflow

Now the configuration of the trigger is complete, you can enable the workflow and notifications will start being sent from Outreach.

enable

Example 3 - Getting around the 10,000 collection limit

As mentioned previously, Outreach limits collections of data to 10,000 - anymore and calls to the API will stop. For example, if we want to collect high volume data with a date range of the past month, chances are that the collection will contain more than 10,000 records. Below is an example of a workaround that collects data for each day in a given month.

enable

The steps involved in this workflow are:

  • Add in today's date as the starting date

  • Set up a main loop which, on it's first run, gets the day before and sets as 'last run'

  • The main loop then gets the total number of calls from Outreach from the day before up to today's date (or the date set from last loop)

  • These calls are then batched into pages - e.g. 135 calls on 3 pages with a maximum of 50 in each page

  • The next sub-loop then lists individual call details

  • A second sub-loop then extracts the data for each call and processes to redshift

  • At the end of the main loop a math helper adds 1 to the count of days and can check if the 30 day limit has been reached - if not the main loop continues

  • Each time the main loop is run, the day before the last run has been set as the starting point for that run of the loop

Let's disect the workflow step by step.

Step 1 - Add the start date

Other than the manual trigger connector, we begin the workflow by using a Date & Time Helper connector. Here we will start the workflow with the current date and work our way backwards for one month (or 30 days). You will set the connectors Operation to Get Current Timestamp, select your timezone and change the date and time format to whichever you prefer.

enable

We then need to be able store the initial date created via the Date & Time Helper connector. The reason for this is because we'll need to be able to retrieve it at a later point in the workflow, modify it, and then replace it with the modified date & time. To do this, we will get a Data Storage connector, give this connector an Operation of Set value, set the scope to current run, set the Key to Current, or whatever you prefer (but remember what you set it as, as we will need it later in the workflow!). Then finally, set its value to the output of date-time-helpers-1.

enable

Following this we will add in a Loop Collection connector and set its Operation to Loop Forever.

enable

Step 2 - Get the day before

After saving the starting time and date in the first Data Storage connector, we then use another Data Storage connector to get its value by changing the Key field to the one that was set in the previous Data Storage connector - in this workflows case we will set it to Current (the same as what was set in Step 1).

enable

Following this we use a Date & Time Helper connector, set its operation to Minus From Date and then change the Date fields input to the contents of the previous Data Storage connector and set the Days field to 1. What this step does is get the day before the current date created via the first Date & Time Helper connector.

enable

To use this new date in the next iteration of the loop, we get another Data Storage connector and set the current Key's value to the result of date-time-helpers-2.

enable

To summarise, what this part of the workflow does is that on every iteration of loop-3 (the Loop Collection connector) it gets the date, finds out the day before, and stores the day before in the Data Storage connector that held the original date.

Step 3 - Get total number of calls

Now that we have the date range, let's get the call data for that date range. Drag in an Outreach connector and set the operation to List Calls, then add a filter and set the Field to createdAt. Once done, change the Critera field to Range of Values and set From to the result of date-time-helpers-2 and the To field to the contents of storage-2.

enable

This will then return all the calls between these two dates with 50 per a page - make sure Per Page in the Outreach connector is set to 50. We now need the total count of pages in this API call. Next, bring in a List Helper connector, set the operation to Get list of page numbers and the Total Count fields value to $.steps.outreach-1.meta.count.

enable

Following this, add in another Loop Collection connector, set its operation to Loop List and put the input fiels value as the result of the previous list (list-helpers-1).

enable

Step 4 - List calls and process them

Let's pull in another Outreach connector to list the calls. Repeat the steps taken for the previous Outreach connector, but set the Page value to the Total Count fields value to $.steps.outreach-1.meta.count.

enable

Following this, add in another Loop Collection connector with the operation set to Loop List, and put the list field to the output of the precedeing Outreach connector. What this does is grab one item from the list ready for the next step. In this example we are processing each item to then be pushed to a data warehouse. You can replace script-2 and redshift-tray-private-1 with connectors that meet your own requirements.

enable

Step 5 - Incrementing the forever loop

To make sure we that we are only returning the past 30 or 31 days in the month (or however many days), we need to add in some logic. After loop-3, let's add in a Math Helper connector and change it's operation to Add. We will then make the First Value a JSON path to the index of loop-3 and the second value an integer of 1. When the workflow reaches this connector, it adds 1 to the index of loop-3.

enable

After this we will place a Boolean Condition connector that checks whether the result of the Math Helper connector is equal to however many days we to collect data for - in our case it's 30. If they are not equal, the workflow continues around the loop, if not, the workflow will terminate by breaking loop-3.

enable
enable

All Operations

Latest version:

3.3

Add prospect to sequence

Add a prospect to a sequence in your Outreach account.

Create account

Create an account in your Outreach account.

Create call

Create a new call in your outreach account.

Create call disposition

Create a new call disposition in your outreach account.

Create call purpose

Create a call purpose in your Outreach account.

Create compliance request

Create a new compliance request in your Outreach account.

Create mailing

Create a new mailing in your outreach account.

Create opportunity

Create an opportunity in your Outreach account.

Create opportunity prospect role

Create an opportunity prospect role in your Outreach account.

Create opportunity stage

Create an opportunity stage in your Outreach account.

Create prospect

Create a prospect in your Outreach account.

Create sequence

Create a sequence in your Outreach account.

Create sequence state

Create a sequence state in your Outreach account.

Create stage

Create a stage in your Outreach account.

Create task

Create a task in your Outreach account.

Delete account

Delete an account from your Outreach account, using their unique ID.

Delete call

Deletes a call from your Outreach account, using their unique ID.

Delete call disposition

Delete an call disposition from your Outreach account, using their unique ID.

Delete call purpose

Delete an call purpose from your Outreach account, using their unique ID.

Delete opportunity

Delete an opportunity from your Outreach account, using their unique ID.

Delete opportunity prospect role

Delete an opportunity prospect role from your Outreach account, using their unique ID.

Delete opportunity stage

Delete an opportunity stage from your Outreach account, using their unique ID.

Delete prospect

Deletes a prospect from your Outreach account, using their unique ID.

Delete sequence

Delete a sequence in your Outreach account, using their unique ID.

Delete sequence state

Delete a sequence state in your Outreach account, using it's unique ID.

Delete stage

Delete a stage in your Outreach account, using their unique ID.

Delete task

Delete a task from your Outreach account, using their unique ID.

Execute link

Execute a link provided by the Outreach API and return it's results. Note: only 'GET' requests will be performed.

Get account

Gets an account from your Outreach account, using their unique ID.

Get call

Gets a call from your Outreach account, using their unique ID.

Get call disposition

Gets a call disposition from your Outreach account, using their unique ID.

Get call purpose

Gets a call purpose from your Outreach account, using their unique ID.

Get compliance request

Retrieve the details for a specific compliance request.

Get event

Gets an event from your Outreach account, using their unique ID.

Get mailbox

Gets a mailbox from your Outreach account, using its unique ID.

Get mailing

Gets a mailing from your Outreach account, using its unique ID.

Get opportunity

Gets an opportunity from your Outreach account, using their unique ID.

Get opportunity prospect role

Gets an opportunity prospect role from your Outreach account, using their unique ID.

Get opportunity stage

Gets an opportunity stage from your Outreach account, using their unique ID.

Get phone number

Gets a phone number of a prospect from your Outreach account, using the phone number ID.

Get prospect

Gets a prospect from your Outreach account, using their unique ID.

Get sequence

Gets a sequence from your Outreach account, using their unique ID.

Get sequence state

Gets a sequence state from your Outreach account, using the sequence state ID.

Get sequence step

Gets a sequence step from your Outreach account, using their unique ID.

Get stage

Gets a stage from your Outreach account, using their unique ID.

Get task

Gets a task from your Outreach account, using their unique ID.

Get user

Gets a user from your Outreach account, using its unique ID.

List accounts

Get a list of accounts in your Outreach account.

List accounts DDL

List audits

Retrieve a list of events that happen during the day.

List call dispositions

List all call dispositions in your account

List call dispositions DDL

List call purposes

List all call purposes in your account

List call purposes DDL

List calls

List all calls in your account

List compliance requests

Retrieve a list of regulatory requests to delete or export personal information.

List events

Get a list of events in your Outreach account.

List mail aliases

Get a list of alternative email names for a mailboxes in your Outreach account.

List mailboxes

Get a list of mailboxes in your Outreach account.

List mailboxes DDL

List mailings

Get a list of mailings in your Outreach account.

List opportunities

Get a list of opportunities in your Outreach account.

List opportunities DDL

List opportunity prospect roles

Get a list of opportunity prospect roles in your Outreach account

List opportunity stages

Get a list of opportunity stages in your Outreach account.

List opportunity stages DDL

List phone numbers

Get a list of phone numbers of prospects in your Outreach account.

List phone numbers DDL

List prospects

Get a list of recent prospects in your Outreach account.

List prospects DDL

List recipients

Get a list of recipients in your Outreach account.

List sequence states

Get a list of sequence states in your Outreach account.

List sequence states DDL

List sequence steps

Get a list of sequence steps in your Outreach account.

List sequence steps DDL

List sequences

Get a list of sequences in your Outreach account.

List sequences DDL

List stages

Get a list of stages in your Outreach account.

List stages DDL

List task priorities

Get a list of task priorities in your Outreach account.

List task priorities DDL

List tasks

Get a list of recent tasks in your Outreach account.

List templates

Get a list of templates in your Outreach account.

List templates DDL

List users

Get a list of users in your Outreach account.

List users DDL

Raw HTTP request (advanced)

Perform a raw HTTP request with some pre-configuration and processing by the connector, such as authentication.

Set sequence state action

Set an action on a sequence state from your Outreach account, using it's unique ID.

Set task action

Set an action on a task from your Outreach account, using their unique ID.

Update account

Update an account by ID in your Outreach account.

Update call disposition

Update a call disposition in your outreach account.

Update call purpose

Update a call purpose in your outreach account.

Update opportunity

Update an opportunity by ID in your Outreach account.

Update opportunity prospect role

Update an opportunity by ID in your Outreach account.

Update opportunity stage

Update an opportunity stage by ID in your Outreach account.

Update prospect

Update a prospect in your Outreach account, using their unique ID.

Update sequence

Update a sequence in your Outreach account, using their unique ID.

Update stage

Update a stage by ID in your Outreach account.