Skip to main content
POST
Add a handle to a contact

Authorizations

Authorization
string
header
required

Dairo API key, e.g. dairo_test_... or dairo_live_...

Path Parameters

contactId
string
required

Body

application/json
channel
string
required

email / a2a / telegram / postal / …

value
string
required

The channel address. For a postal handle this is the one-line formatted address (for display); the structured address goes in metadata.

Maximum string length: 500
label
string
isPrimary
boolean
default:false
metadata
object

Structured extras. REQUIRED for a postal handle: { name, street, line2?, postalCode, city, state?, country } (see PostalAddress). name/street/postalCode/city/country are required; country is an ISO-3166 alpha-2 code or a country name.

Response

Success

contactHandle
object
required