Skip to main content
Server path: /customerio-campaigns | Type: Application | PCID required: Yes

Tools

ToolDescription
customerio_campaigns_broadcast_action_linksGet broadcast action link metrics
customerio_campaigns_broadcast_action_metricsGet broadcast action metrics
customerio_campaigns_broadcast_actionsList broadcast actions
customerio_campaigns_broadcast_errorsGet broadcast error descriptions
customerio_campaigns_broadcast_linksGet broadcast link metrics
customerio_campaigns_broadcast_messagesGet messages for a broadcast
customerio_campaigns_broadcast_metricsGet broadcast metrics
customerio_campaigns_broadcast_statusGet the status of a broadcast
customerio_campaigns_campaign_action_linksGet link metrics for an action
customerio_campaigns_campaign_action_metricsGet campaign action metrics
customerio_campaigns_campaign_journey_metricsGet campaign journey metrics
customerio_campaigns_campaign_link_metricsGet campaign link metrics
customerio_campaigns_campaign_metricsGet campaign metrics
customerio_campaigns_get_broadcastGet a broadcast
customerio_campaigns_get_broadcast_actionGet a broadcast action
customerio_campaigns_get_broadcast_action_languageGet a translation of a broadcast message
customerio_campaigns_get_campaign_actionGet a campaign action
customerio_campaigns_get_campaign_action_translationGet a translation of a campaign message
customerio_campaigns_get_campaign_messagesGet campaign message metadata
customerio_campaigns_get_campaignsGet a campaign
customerio_campaigns_list_broadcast_triggersGet broadcast triggers
customerio_campaigns_list_broadcastsList broadcasts
customerio_campaigns_list_campaign_actionsList campaign actions
customerio_campaigns_list_campaignsList campaigns
customerio_campaigns_update_broadcast_actionUpdate a broadcast action
customerio_campaigns_update_broadcast_action_languageUpdate a translation of a broadcast message
customerio_campaigns_update_campaign_actionUpdate a campaign action
customerio_campaigns_update_campaign_action_translationUpdate a translation of a campaign message

Get broadcast action link metrics Parameters:
ParameterTypeRequiredDefaultDescription
broadcast_idintegerYesThe identifier of a broadcast.
action_idintegerYesThe action you want to lookup or act on.
periodstringNoThe unit of time for your report.
stepsintegerNoThe number of periods you want to return. Defaults to the maximum available, or 12 if the period is in months. Maximums are 24 hours, 45 days, 12 weeks, or 121 months. Days start at 00:00 EST. Weeks start at 00:00 EST on Sunday. Months start at 00:00 EST on the 1st of the month.
typestringNoThe type of item you want to return metrics for. When empty, the response contains metrics for all possible types.

customerio_campaigns_broadcast_action_metrics

Get broadcast action metrics Parameters:
ParameterTypeRequiredDefaultDescription
broadcast_idintegerYesThe identifier of a broadcast.
action_idintegerYesThe action you want to lookup or act on.
periodstringNoThe unit of time for your report.
stepsintegerNoThe number of periods you want to return. Defaults to the maximum available, or 12 if the period is in months. Maximums are 24 hours, 45 days, 12 weeks, or 121 months. Days start at 00:00 EST. Weeks start at 00:00 EST on Sunday. Months start at 00:00 EST on the 1st of the month.
typestringNoThe type of item you want to return metrics for. When empty, the response contains metrics for all possible types.

customerio_campaigns_broadcast_actions

List broadcast actions Parameters:
ParameterTypeRequiredDefaultDescription
broadcast_idintegerYesThe identifier of a broadcast.

customerio_campaigns_broadcast_errors

Get broadcast error descriptions Parameters:
ParameterTypeRequiredDefaultDescription
broadcast_idintegerYesThe ID of the broadcast that you want to return information about.
trigger_idintegerYesThe ID of the campaign trigger that you want to return information for.
startstringNoThe token for the page of results you want to return. Responses contain a next property. Use this property as the start value to return the next page of results.
limitintegerNoThe maximum number of results you want to retrieve per page.

Get broadcast link metrics Parameters:
ParameterTypeRequiredDefaultDescription
broadcast_idintegerYesThe identifier of a broadcast.
periodstringNoThe unit of time for your report.
stepsintegerNoThe number of periods you want to return. Defaults to the maximum available, or 12 if the period is in months. Maximums are 24 hours, 45 days, 12 weeks, or 121 months. Days start at 00:00 EST. Weeks start at 00:00 EST on Sunday. Months start at 00:00 EST on the 1st of the month.
uniquebooleanNoIf true, the response contains only unique customer results, i.e. a customer who clicks a link twice is only counted once. If false, the response contains the total number of results without regard to uniqueness.

customerio_campaigns_broadcast_messages

Get messages for a broadcast Parameters:
ParameterTypeRequiredDefaultDescription
broadcast_idintegerYesThe identifier of a broadcast.
startstringNoThe token for the page of results you want to return. Responses contain a next property. Use this property as the start value to return the next page of results.
limitintegerNoThe maximum number of results you want to retrieve per page.
metricstringNoDetermines the metric(s) you want to return.
statestringNoThe state of a broadcast.
typestringNoThe type of item you want to return metrics for. When empty, the response contains metrics for all possible types.
start_tsintegerNoThe beginning timestamp for your query.
end_tsintegerNoThe ending timestamp for your query.
get_tracked_responsesbooleanNoIf true, the response includes tracked_responses for each message—an object containing tracked response option names for in-app survey responses.

customerio_campaigns_broadcast_metrics

Get broadcast metrics Parameters:
ParameterTypeRequiredDefaultDescription
broadcast_idintegerYesThe identifier of a broadcast.
periodstringNoThe unit of time for your report.
stepsintegerNoThe number of periods you want to return. Defaults to the maximum available, or 12 if the period is in months. Maximums are 24 hours, 45 days, 12 weeks, or 121 months. Days start at 00:00 EST. Weeks start at 00:00 EST on Sunday. Months start at 00:00 EST on the 1st of the month.
typestringNoThe type of item you want to return metrics for. When empty, the response contains metrics for all possible types.

customerio_campaigns_broadcast_status

Get the status of a broadcast Parameters:
ParameterTypeRequiredDefaultDescription
broadcast_idintegerYesThe ID of the broadcast that you want to return information about.
trigger_idintegerYesThe ID of the campaign trigger that you want to return information for.

Get link metrics for an action Parameters:
ParameterTypeRequiredDefaultDescription
campaign_idintegerYesThe ID of the campaign that you want to trigger or return information about.
action_idintegerYesThe action you want to lookup or act on.
periodstringNoThe unit of time for your report.
stepsintegerNoThe number of periods you want to return. Defaults to the maximum available, or 12 if the period is in months. Maximums are 24 hours, 45 days, 12 weeks, or 121 months. Days start at 00:00 EST. Weeks start at 00:00 EST on Sunday. Months start at 00:00 EST on the 1st of the month.
typestringNoThe type of item you want to return metrics for. When empty, the response contains metrics for all possible types.

customerio_campaigns_campaign_action_metrics

Get campaign action metrics Parameters:
ParameterTypeRequiredDefaultDescription
campaign_idintegerYesThe ID of the campaign that you want to trigger or return information about.
action_idintegerYesThe action you want to lookup or act on.
versionstringYesThe version of the metrics API to use.
typestringNoThe type of item you want to return metrics for. When empty, the response contains metrics for all possible types.
resstringNoVersion 2 only. Determines increment for metrics—hourly, daily, weekly, or monthly.
tzstringNoVersion 2 only. The time zone for the metrics you are requesting. If you do not provide a time zone, we use EST. You must use the region format.
startintegerNoVersion 2 only. The unix timestamp for the beginning of your metrics.
endintegerNoVersion 2 only. The unix timestamp for the end of your metrics. Limited to 10 years from the start parameter.
periodstringNoVersion 1 only. The unit of time for your report.
stepsintegerNoVersion 1 only. The number of periods you want to return. Defaults to the maximum available, or 12 if the period is in months. Maximums are 24 hours, 45 days, 12 weeks, or 120 months.

customerio_campaigns_campaign_journey_metrics

Get campaign journey metrics Parameters:
ParameterTypeRequiredDefaultDescription
campaign_idintegerYesThe ID of the campaign that you want to trigger or return information about.
startintegerYesThe unix timestamp for the beginning of your journey metrics report.
endintegerYesThe unix timestamp for the end of your journey metrics report.
resstringYesDetermines increment for metrics—hourly, daily, weekly, or monthly.

Get campaign link metrics Parameters:
ParameterTypeRequiredDefaultDescription
campaign_idintegerYesThe ID of the campaign that you want to trigger or return information about.
periodstringNoThe unit of time for your report.
stepsintegerNoThe number of periods you want to return. Defaults to the maximum available, or 12 if the period is in months. Maximums are 24 hours, 45 days, 12 weeks, or 121 months. Days start at 00:00 EST. Weeks start at 00:00 EST on Sunday. Months start at 00:00 EST on the 1st of the month.
uniquebooleanNoIf true, the response contains only unique customer results, i.e. a customer who clicks a link twice is only counted once. If false, the response contains the total number of results without regard to uniqueness.

customerio_campaigns_campaign_metrics

Get campaign metrics Parameters:
ParameterTypeRequiredDefaultDescription
campaign_idintegerYesThe ID of the campaign that you want to trigger or return information about.
versionstringYesThe version of the metrics API to use.
typestringNoThe type of item you want to return metrics for. When empty, the response contains metrics for all possible types.
resstringNoVersion 2 only. Determines increment for metrics—hourly, daily, weekly, or monthly.
tzstringNoVersion 2 only. The time zone for the metrics you are requesting. If you do not provide a time zone, we use EST. You must use the region format.
startintegerNoVersion 2 only. The unix timestamp for the beginning of your metrics.
endintegerNoVersion 2 only. The unix timestamp for the end of your metrics. Limited to 10 years from the start parameter.
periodstringNoVersion 1 only. The unit of time for your report.
stepsintegerNoVersion 1 only. The number of periods you want to return. Defaults to the maximum available, or 12 if the period is in months. Maximums are 24 hours, 45 days, 12 weeks, or 120 months.

customerio_campaigns_get_broadcast

Get a broadcast Parameters:
ParameterTypeRequiredDefaultDescription
broadcast_idintegerYesThe identifier of a broadcast.

customerio_campaigns_get_broadcast_action

Get a broadcast action Parameters:
ParameterTypeRequiredDefaultDescription
broadcast_idintegerYesThe identifier of a broadcast.
action_idintegerYesThe action you want to lookup or act on.

customerio_campaigns_get_broadcast_action_language

Get a translation of a broadcast message Parameters:
ParameterTypeRequiredDefaultDescription
broadcast_idintegerYesThe identifier of a broadcast.
action_idintegerYesThe action you want to lookup or act on.
languagestringYesA language tag of a language variant. If you don’t provide a language (an empty string), we’ll use your default language. If the language variant does not exist, we’ll return an error.

customerio_campaigns_get_campaign_action

Get a campaign action Parameters:
ParameterTypeRequiredDefaultDescription
campaign_idintegerYesThe ID of the campaign that you want to trigger or return information about.
action_idintegerYesThe action you want to lookup or act on.

customerio_campaigns_get_campaign_action_translation

Get a translation of a campaign message Parameters:
ParameterTypeRequiredDefaultDescription
campaign_idintegerYesThe ID of the campaign that you want to trigger or return information about.
action_idintegerYesThe action you want to lookup or act on.
languagestringYesA language tag of a language variant. If you don’t provide a language (an empty string), we’ll use your default language. If the language variant does not exist, we’ll return an error.

customerio_campaigns_get_campaign_messages

Get campaign message metadata Parameters:
ParameterTypeRequiredDefaultDescription
campaign_idintegerYesThe ID of the campaign that you want to trigger or return information about.
startstringNoThe token for the page of results you want to return. Responses contain a next property. Use this property as the start value to return the next page of results.
limitintegerNoThe maximum number of results you want to retrieve per page.
typestringNoThe type of item you want to return metrics for. When empty, the response contains metrics for all possible types.
metricstringNoDetermines the metric(s) you want to return.
draftsbooleanNoIf true, your request returns drafts rather than active/sent messages.
start_tsintegerNoThe beginning timestamp for your query.
end_tsintegerNoThe ending timestamp for your query.
get_tracked_responsesbooleanNoIf true, the response includes tracked_responses for each message—an object containing tracked response option names for in-app survey responses.

customerio_campaigns_get_campaigns

Get a campaign Parameters:
ParameterTypeRequiredDefaultDescription
campaign_idintegerYesThe ID of the campaign that you want to trigger or return information about.

customerio_campaigns_list_broadcast_triggers

Get broadcast triggers Parameters:
ParameterTypeRequiredDefaultDescription
broadcast_idintegerYesThe identifier of a broadcast.

customerio_campaigns_list_broadcasts

List broadcasts

customerio_campaigns_list_campaign_actions

List campaign actions Parameters:
ParameterTypeRequiredDefaultDescription
campaign_idintegerYesThe ID of the campaign that you want to trigger or return information about.
startstringNoThe token for the page of results you want to return. Responses contain a next property. Use this property as the start value to return the next page of results.

customerio_campaigns_list_campaigns

List campaigns

customerio_campaigns_update_broadcast_action

Update a broadcast action Parameters:
ParameterTypeRequiredDefaultDescription
broadcast_idintegerYesThe identifier of a broadcast.
action_idintegerYesThe action you want to lookup or act on.
bodyobjectNoRequest body

customerio_campaigns_update_broadcast_action_language

Update a translation of a broadcast message Parameters:
ParameterTypeRequiredDefaultDescription
broadcast_idintegerYesThe identifier of a broadcast.
action_idintegerYesThe action you want to lookup or act on.
languagestringYesA language tag of a language variant. If you don’t provide a language (an empty string), we’ll use your default language. If the language variant does not exist, we’ll return an error.
bodyobjectNoRequest body

customerio_campaigns_update_campaign_action

Update a campaign action Parameters:
ParameterTypeRequiredDefaultDescription
campaign_idintegerYesThe ID of the campaign that you want to trigger or return information about.
action_idintegerYesThe action you want to lookup or act on.
bodyobjectNoRequest body

customerio_campaigns_update_campaign_action_translation

Update a translation of a campaign message Parameters:
ParameterTypeRequiredDefaultDescription
campaign_idintegerYesThe ID of the campaign that you want to trigger or return information about.
action_idintegerYesThe action you want to lookup or act on.
languagestringYesA language tag of a language variant. If you don’t provide a language (an empty string), we’ll use your default language. If the language variant does not exist, we’ll return an error.
bodyobjectNoRequest body