Sign in

v51

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-014102371.0 MB
ServiceAgent

Claim an unresolved contact address (service agent)

Attaches a currently-unresolved contact address (contact_id is NULL) to the given contact, as a service agent. Idempotent if already claimed by the same contact; returns 409 if claimed by a different contact.

post/service_agents/contact_addresses/{id}/claim

Path parameters

idstring uuid required

The ID of the contact address to claim.

Request body

contact_idstring uuid required

Example request

{
  "contact_id": "5e4a0680-eba3-4001-a000-000000000001"
}

Response

Address claimed successfully.

type'' | 'agent' | 'conference' | 'email' | 'extension' | 'line' | 'sip' | 'tel' | 'web_session'

Type of address.

targetstring

The address endpoint. Format depends on type: phone number for tel (e.g. +14155551234), UUID for agent/conference/extension, email for email, SIP URI for sip.

target_namestring

Address's name.

namestring

Optional label for this address.

detailstring

Additional notes about this address.

idstring uuid

Unique identifier for the address.

contact_idstring uuid

Unique identifier of the contact this address belongs to.

customer_idstring uuid

Unique identifier of the customer this address belongs to.

is_primaryboolean

Indicates if this is the primary address for the given type.

tm_createstring date-time

Timestamp when the address was created.

Example response

{
  "type": "tel",
  "target": "+14155551234",
  "target_name": "John Smith",
  "name": "Main Office",
  "detail": "Primary contact number",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "contact_id": "7c4d2f3a-1b8e-4f5c-9a6d-3e2f1a0b4c5d",
  "customer_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "is_primary": true,
  "tm_create": "2026-01-15T09:30:00.000000Z"
}