Dynamo Developer DocsDynamo Developer Docs
Audience APIUsers

Report a purchase

Report revenue for a purchase made by a user. Send a single object or a `batch` of up to 250.

post/v1.0/user/purchase

Authorization

x-api-key x-date x-signature x-api-version
x-api-key<token>

Your organization API key.

In: header

x-date<token>

Request timestamp as an IMF-fixdate string (GMT, US locale) "EEE, dd MMM yyyy HH:mm:ss z", e.g. "Sun, 06 Dec 2020 12:59:11 GMT". 30-second TTL.

In: header

x-signature<token>

HMAC-SHA256(x-date, secret) as lowercase hex.

In: header

x-api-version<token>

Optional for the Audience API — accepted and ignored; included for consistency with the External API (where it is required). Send 1.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

Try it

live — writes real data

Kept in this tab only and signed in your browser — your secret never leaves your device.

Body (JSON)

This sends a real POST to your live organization.

Enter your key and secret to send.

curl -X POST "https://example.com/v1.0/user/purchase" \  -H "Content-Type: application/json" \  -d '{    "revenue": 49.99,    "userId": "user_123"  }'
Empty
{  "message": "Signature expired"}

Get a user's properties

Return all reported properties of a user.

Mark a conversion

Mark a conversion for a user who arrived via a Dynamo deep link. Optionally identify the user with their Dynamo user id and control whether they are excluded from future activity/audience targeting. Returns the known user id if one exists.