Outbound

Outbound

Upon disposition of the respondent session, the respondent will be redirected to the partner’s platform. Only a single redirect URL is supported per partner configuration.

https://example.partner.com/dynata/end

Note

The redirect URL can be configured with query string parameters, but the values must be static.

https://example.partner.com/dynata/end?static_param=1234&another_static_pamam=abcd

https://example.partner.com?disposition=1&status=0&access_key=1234&expiration=2021-10-19T17:48:36.480Z&signature=c156e91013eb715edb2b07df5491497a807206b1796bb7d031505107a9dbdcdf

Query Parameters

Required

parameter	description
disposition	The primary indicator of a respondent’s session outcome.
status	A more detail description of respondent’s session outcome.
expiration	RFC3339 timestamp indicating request expiration.
access_key	Partner’s outbound access_key.
signature	String created using the Dynata signing algorithm.

Aliases

Upon request, any of the standard Dynata query string parameters can be aliased to a different name of the partner’s choosing, so long as the alias does not conflict with another standard parameter name.

Dispositions

All redirect URLs will contain a query string parameters for disposition and of status. The disposition parameter contains an integer value indicating the disposition of the respondent session. The status parameter contains an integer value indicating more detail about the disposition. The possible values for each disposition and their associated status values are documented here.

Signature

All redirect URLs, upon return to the partner, are signed using the Dynata signing algorithm. The access_key and secret_key used for signing are different than the key pair that’s used for gateway API calls and entry URLs into the Dynata platform.

Important

It’s up to the partner to verify the authenticity of the redirect URL by validating the signature query string parameter, and observing the expiration. The redirect URL can be validated by reconstructing the signature and comparing the constructed value against the signature provided in the redirect URL. If the two values don’t match, then the URL has been altered.

Additional Parameters

Any extraneous query string parameters that were passed in with the respondent via entry URL will be appended to the redirect URL upon return of the respondent to the partner.