Custom Redirect Object

Track links on your website or third-party site with Account Engagement’s custom redirects. For example, you can track a link on your Twitter page or a banner ad on a third-party site. When a user clicks a link, a corresponding activity is created on their profile. Learn about custom redirects in Salesforce Help.

Include the authentication header with every request. For information on how to authenticate, see Authentication.

Resource NameOperationDescription
Custom Redirect ReadGETRequest information for a single custom redirect record.
Custom Redirect QueryGETRequest information for custom redirects that match the specified criteria.

Request information for a single custom redirect record.

Replace <ID> with the Pardot ID of the custom redirect.

Request the information for the custom redirect with ID 1234.

Requests information about custom redirects that match the specified criteria. You can specify the custom redirects and fields to request. A maximum of 200 custom redirects are returned. To return all custom redirects, specify the output as mobile.

Note: To request information about a specific custom redirect, use Custom Redirect Read.

Use these parameters to specify the custom redirects to return. Parameters can be used in any combination and in any order unless otherwise specified.

Notes:

ParameterTypePossible ValuesDescription
created_afterstringtoday, yesterday, last_7_days, this_month, last_month,<custom_time>Requests custom redirects created after the specified time. Example: To request custom redirects created in 2020, use /api/customRedirect/version/4/do/query?created_after=2019-12-31%2024:59:59.
created_beforestringtoday, yesterday, last_7_days, this_month, last_month, <custom_time>Requests custom redirects created before the specified date and time. Doesn’t include custom redirects created at the specified time. Example: To request custom redirects created before today (but not created today), use /api/customRedirect/version/4/do/query?created_before=today.
id_greater_thanintegerAny positive integerRequests custom redirects that have an ID greater than the specified number.
id_less_thanintegerAny positive integerReturns custom redirects that have an ID less than the specified number.
updated_afterstringtoday, yesterday, last_7_days, this_month, last_month, <custom_time>Requests custom redirects that were last updated after the specified date and time.
updated_beforestringtoday, yesterday, last_7_days, this_month, last_month, <custom_time>Selects custom redirects that were last updated before the specified date and time.

Use these parameters to specify which custom redirect fields are returned, and how the custom redirects are sorted.

ParameterTypePossible ValuesDescription
limitintegerAny integer from 1 through 200.The number of custom redirects to return. Default value is 200.
offsetintegerAny positive integerThe number of custom redirects to omit from the response (the number to "skip over"). Example: Retrieve a list of custom redirects, omitting the 50 most recently updated custom redirects. Sort the query by the updated_at field and use offset=50: api/customRedirect/version/4/do/query?sort_by=updated_at&offset=50
sort_bystringcreated_at, idThe field by which the results are sorted. See Sort Order.
sort_orderstringascending, descending, updated_atThe sort order. The default value depends on which sort_by parameter you specify. See Sort Order.

Use the sort_by parameter to specify which field Account Engagement uses to sort the results. Different fields have different default sort orders.

ValueDefault Sort OrderDescription
created_atdescendingSort the results by the custom redirects' created_at timestamps.
idascendingSort the results by the custom redirects' id fields.
updated_atdescendingSort the results by the custom redirects' updated_at timestamps.

The XML response for a query request contains information about multiple custom redirects. The XML response for a read request contains information about a single custom redirect.

TagDescription
<result>Parent tag. The custom redirects that match the parameters specified in your query.
<total_results>The number of custom redirects selected by the query. Note: The query request returns a maximum of 200 custom redirects. If your query matches more than 200 custom redirects, you can make several requests to retrieve all matching custom redirects.
<customRedirect>The information for a single custom redirect. See Custom Redirect in Object Field References.
TagDescription
<customRedirect>The information for a single custom redirect. See Custom Redirect in Object Field References.