Auth

Register a message return line

Registers the current provider-owned SMS/iMessage return line for the acting agent before that phone is used in message sign-in URLs. Configure stores only a hash and last4.

post/v1/auth/sign-in/message-lines

Request

  • Base URL: https://api.configure.dev
  • URL: https://api.configure.dev/v1/auth/sign-in/message-lines
  • Auth: API key in header X-API-Key

Headers

X-Agentstring
Example:your-agent

Required when the API key's developer account owns more than one active agent.

Request body

channelstring
phonestring required

Current provider-owned message return line in E.164 format.

labelstring nullable
metadataobject

Small server-side metadata object for provider bookkeeping.

Example request

{
  "channel": "sms",
  "phone": "+14155550123",
  "label": "Primary SMS line"
}

Response

Message return line registered.

Example response

{
  "line": {
    "channel": "sms",
    "phoneLast4": "0123",
    "label": "Primary SMS line"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.