Create Text Messaging Sender

post

https://a.klaviyo.com/api/text-messaging-senders

Create a sender and submit its initial registration.

A toll-free number is provisioned in all supported regions (US + CA), so the response is the sender for the requested country and the sibling-region sender also appears in list/retrieve.

Rate limits:
Burst: 1/s
Steady: 15/m

Scopes:
sender-config:write

OpenAPI Spec

Query Params

fields[text-messaging-sender-registration]

array of strings

For more information please visit https://developers.klaviyo.com/en/v2026-10-15/reference/api-overview#sparse-fieldsets

fields[text-messaging-sender-registration]

Allowed:

fields[text-messaging-sender]

array of strings

For more information please visit https://developers.klaviyo.com/en/v2026-10-15/reference/api-overview#sparse-fieldsets

fields[text-messaging-sender]

include

array of strings

For more information please visit https://developers.klaviyo.com/en/v2026-10-15/reference/api-overview#relationships

include

Allowed:

Body Params

Create a text-messaging sender.

data

object

required

Headers

revision

string

required

Defaults to 2026-10-15

API endpoint revision (format: YYYY-MM-DD[.suffix])

Responses

201Success

4XXClient Error

5XXServer Error