Send your event data from RudderStack to PersistIQ.
4 minute read
PersistIQ is an outbound sales automation and customer discovery platform. It helps you find new customers, onboard them, and organize your outreach strategies effectively.
Once you have confirmed that the source platform supports sending events to PersistIQ, follow these steps:
From your RudderStack dashboard, add a source. Then, from the list of destinations, select PersistIQ.
Assign a name to the destination and click Continue.
Connection settings
To successfully configure PersistIQ as a destination, you will need to configure the following settings:
PersistIQ REST API Key: Enter your PersistIQ API key. For more information on obtaining the API key, refer to the FAQ section below.
Map RudderStack user attributes to PersistIQ Lead attributes: Use this setting to map your RudderStack event properties to the custom or non-standard PersistIQ lead attributes.
Identify
You can use RudderStack’s identify call to create or update a lead (prospect) in PersistIQ. RudderStack sends the user information to PersistIQ via their /leads endpoint.
Creating a new lead
A sample identify call that creates a new lead in PersistIQ is shown below:
rudderanalytics.identify("1hKOmRA4GRlm",{name:"Alex Keener",address:"99 Blue Gum Street",email:"alex@example.com"})
RudderStack automatically maps all common attributes like name, email, city, etc. to the PersistIQ lead attributes. To map specific event properties to the custom PersistIQ lead attributes, use the Map RudderStack user attributes to PersistIQ Lead attributes dashboard setting to specify the mapping.
Supported mappings
The following table lists the mappings between the RudderStack properties and PersistIQ attributes:
RudderStack does not batch events before sending them to PersistIQ. Hence, the index inside the lead array is always 0.
Updating an existing lead
RudderStack automatically updates a lead if the identify call contains the persistIqLeadId field in the externalId object. Otherwise, it creates a new lead.
A sample identify call that updates an existing PersistIQ lead is shown below:
rudderanalytics.identify("1hKOmRA4GRlm",{name:"Alex Keener",address:"99 Blue Gum Street",email:"alex@example.com"},{"externalId":[{"type":"persistIqLeadId","id":"abc12345"}]})
For more information on getting your PersistIQ lead ID, refer to the FAQ section below.
Supported mappings
The following table list the mappings between the RudderStack properties and PersistIQ attributes:
The lead status passed in the traits.status/context.traits.status must already be configured in your PersistIQ dashboard.
Group
You can use the group events to add or remove a lead from a group in PersistIQ. RudderStack uses the /campaigns endpoint to send this information to PersistIQ.
A sample group call is shown below:
rudderanalytics.group("group01",{mailbox_id:"mbid123",operation:"add"// set to remove to remove user from a group
},{"externalId":[{"type":"persistIqLeadId","id":"abc12345"}]})
If not explicitly specified, RudderStack automatically sets the traits.operation parameter to add. To remove a user from the group, set this parameter to remove.
Supported mappings
The following table list the mappings between the RudderStack properties and PersistIQ attributes:
RudderStack property
PersistIQ property
groupId Required
campaign_id
externalId.persistIqLeadId Required
leadId
traits.mailbox_id context.traits.mailbox_id
mailbox_id
FAQ
Where can I find the PersistIQ API key?
To get your PersistIQ API key, follow these steps:
This site uses cookies to improve your experience while you navigate through the website. Out of
these
cookies, the cookies that are categorized as necessary are stored on your browser as they are as
essential
for the working of basic functionalities of the website. We also use third-party cookies that
help
us
analyze and understand how you use this website. These cookies will be stored in your browser
only
with
your
consent. You also have the option to opt-out of these cookies. But opting out of some of these
cookies
may
have an effect on your browsing experience.
Necessary
Always Enabled
Necessary cookies are absolutely essential for the website to function properly. This
category only includes cookies that ensures basic functionalities and security
features of the website. These cookies do not store any personal information.
This site uses cookies to improve your experience. If you want to
learn more about cookies and why we use them, visit our cookie
policy. We'll assume you're ok with this, but you can opt-out if you wish Cookie Settings.