Create DDEX sender identity

Attest and register an organization DPID sender identity for later use by sandbox or approved live partner connections.

Authorization

BearerAuth

AuthorizationBearer <token>

In: header

Header Parameters

Idempotency-Key*string

Unique request key. Reuse with the same body replays the result; reuse with a different body returns a conflict.

Length8 <= length <= 255

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name*string

Length1 <= length <= 150

dpid*string

Valid PADPIDA identifier in canonical or human-readable hyphenated form.

Lengthlength <= 100

attestation*boolean

Must be true to attest that the organization controls this DPID.

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/ddex/sender-identities" \  -H "Idempotency-Key: stringst" \  -H "Content-Type: application/json" \  -d '{    "name": "Example Records",    "dpid": "PA-DPIDA-2026073001-N",    "attestation": true  }'

{  "data": {    "reference": "4a077d69-e377-43cd-9abb-43f68cd73da1",    "name": "Example Records",    "dpid": "PA-DPIDA-2026073001-N",    "status": "attested"  }}

Authorization

Header Parameters

Request Body

Response Body

201application/json

401application/json

403application/json

422application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`