Grant consent

Records consent for a phone number on a specific line. Required before making outbound calls (explicit_outbound) or automatically recorded on inbound calls (implied_inbound).

Authentication

AuthorizationBearer

Send as Authorization: Bearer <your-key>. Obtain keys from the portal — prefix sk_live_ for production, sk_test_ for sandbox.

Request

This endpoint expects an object.
phone_numberstringRequired
E.164 phone number to grant consent for
line_idstringRequiredformat: "uuid"
Line ID to scope the consent to
consent_typeenumRequired
Allowed values:
sourcestringRequired>=1 character

How consent was obtained (e.g. “web_form”, “verbal”, “api”)

Response

Consent granted
consentobject

Errors

401
Unauthorized Error
404
Not Found Error
422
Unprocessable Entity Error
429
Too Many Requests Error