Spotify
Platform Summary
Spotify alias and conversion identifier contracts.
Scope
Primary execution surface: hybrid.
Developer Source Map
| Source | Reason |
|---|---|
| Spotify Ads API Guides | Event Contracts; Transport / Payload Rules; User Data Contracts; events, payload, transport |
| Spotify Ads API Pixel Reference | pixel objects, transport |
RudderStack Cross-Check
No destination mapping linked for this platform.
Verified Contracts
Event Contracts
| Object / Event | Field | Applies To | Type | Requirement | Exact Format | Normalization | Hashing | Examples | Caveat | Primary Source | Status | Confidence |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
capi_event | event_details | server | object | Optional | Free-form event details object. | Not clearly specified | Not clearly specified | - | Spotify Ads API guides mark event_details as optional. | Spotify Ads API Guides | Verified | Medium |
capi_event | event_name | server | string | Required | Required event name in CAPI event object. | Not clearly specified | Not clearly specified | Purchase | Spotify Ads API guides mark event_name as required. | Spotify Ads API Guides | Verified | High |
capi_event | event_time | server | string | Required | ISO 8601 timestamp (UTC recommended). | Not clearly specified | Not clearly specified | - | Spotify Ads API guides mark event_time as required. | Spotify Ads API Guides | Verified | High |
User Data Contracts
| Object / Event | Field | Applies To | Type | Requirement | Exact Format | Normalization | Hashing | Examples | Caveat | Primary Source | Status | Confidence |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
capi_event | user_data | server | object | Required | One or more identifiers in user_data object. | Not clearly specified | Not clearly specified | - | Spotify Ads API guides mark user_data as required. | Spotify Ads API Guides | Verified | High |
capi_event.user_data | hashed_emails | server | array<string> | Optional | SHA-256 hashed email values. | Not clearly specified | SHA-256 | <sha256(alice@example.com)> | Identifier field documented in guides. | Spotify Ads API Guides | Verified | High |
capi_event.user_data | hashed_phone_number | server | string | Optional | SHA-256 hashed phone number. | Not clearly specified | SHA-256 | <sha256(16505551234)> | Identifier field documented in guides. | Spotify Ads API Guides | Verified | High |
Candidate / Needs Review Items
Transport / Payload Rules
| Object / Event | Field | Applies To | Type | Requirement | Exact Format | Normalization | Hashing | Examples | Caveat | Primary Source | Status | Confidence |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
capi_request | endpoint | server | string | Required | CAPI direct events endpoint. | Not clearly specified | Not clearly specified | - | Endpoint usage shown in official guide request example. | Spotify Ads API Guides | Needs manual review | Medium |
Excluded Items
No excluded rows in this revision.
Last Reviewed
2026-03-31