Create a text messaging sender
https://email.growthdept.ai/api/text-messaging-sendersRequests a toll-free number for the account with its toll-free verification. The sender stays registering until the carrier approves it and Growth Dept has connected a texting provider.
The request body can be up to 5 MB.
Rate limits
Scopes
sender-config:write
Operation id
create_text_messaging_sender The same operation as in Klaviyo's API. OpenAPI document
Query parameters
array of strings
Attributes of text-messaging-sender-registration resources to return.
Pick values to add them to the request:
Pick values to add them to the request:
Pick values to add them to the request:
Body
Send application/vnd.api+json or application/json.
object
dataobjectrequired
data: 5 fields
typestringrequired
text-messaging-senderidstring
attributesobjectrequired
attributes: 4 fields
sender_typestringrequired
alphalong_codeshort_codetoll_freevanity_short_codesender_detailsobjectrequired
sender_details: 1 field
countrystringrequired
CAUS
text-messaging-sender-registrationobjectrequired
text-messaging-sender-registration: 1 field
dataobjectrequired
data: 2 fields
typestringrequired
text-messaging-sender-registrationattributesobjectrequired
attributes: 14 fields
first_namestringrequired
last_namestringrequired
phone_numberstringrequired
emailstring (email)required
addressobjectrequired
address: 6 fields
street_address_1stringrequired
street_address_2object
citystringrequired
regionstringrequired
postal_codestringrequired
countrystringrequired
business_typestringrequired
GOVERNMENTNON_PROFITPRIVATE_PROFITPUBLIC_PROFITSOLE_PROPRIETORbusiness_namestringrequired
business_websitestringrequired
doing_business_asstring
business_registration_countrystring
business_registration_authoritystring
business_registration_numberstring
privacy_policy_urlstring
terms_of_service_urlstring
forwarding_numberstringcan be null
relationshipsobject
metaobject
Edit the example. The code samples use what you type here.
Headers
stringrequireddefault 2026-10-15
API revision, YYYY-MM-DD. This server implements 2026-10-15.
Responses
201Success
Response body
object
dataobjectrequired
data: 5 fields
typestringrequired
text-messaging-senderidstringrequired
attributesobjectrequired
attributes: 6 fields
sender_typestringrequired
alphalong_codeshort_codetoll_freevanity_short_codesender_detailsobjectrequired
sender_details: 1 field
countrystringrequired
statusstringrequired
activepending_registrationregisteringregistration_failedsuspendedcreated_atstring (date-time)required
forwarding_numberstringcan be null
sender_identifierstringcan be null
relationshipsobject
relationships: 1 field
text-messaging-sender-registrationobject
text-messaging-sender-registration: 2 fields
dataobject
data: 2 fields
typestringrequired
text-messaging-sender-registrationidstringrequired
linksobject
links: 2 fields
selfstring (uri)required
relatedstring (uri)required
linksobjectrequired
links: 1 field
selfstring (uri)required
includedarray of objects
included: 5 fields
typestringrequired
text-messaging-sender-registrationidstringrequired
attributesobjectrequired
attributes: 6 fields
statusstringrequired
action_requiredapprovedin_reviewrejectedfailuresarray of objectsrequired
failures: 1 field
detailstringrequired
created_atstring (date-time)required
updated_atstring (date-time)required
submitted_atstring (date-time)can be null
decided_atstring (date-time)can be null
relationshipsobject
relationships: 1 field
text-messaging-senderobject
text-messaging-sender: 2 fields
dataobject
data: 2 fields
typestringrequired
text-messaging-senderidstringrequired
linksobject
links: 2 fields
selfstring (uri)required
relatedstring (uri)required
linksobjectrequired
links: 1 field
selfstring (uri)required
linksobject
links: 1 field
selfstring (uri)required
metaobject
4XXClient error
Response body
object
errorsarray of objectsrequired
errors: 8 fields
idstringrequired
statusintegerrequired
codestringrequired
titlestringrequired
detailstringrequired
sourceobject
source: 2 fields
pointerstring
parameterstring
linksobject
metaobject
See status codes for each code.
5XXServer error
Response body
object
errorsarray of objectsrequired
errors: 8 fields
idstringrequired
statusintegerrequired
codestringrequired
titlestringrequired
detailstringrequired
sourceobject
source: 2 fields
pointerstring
parameterstring
linksobject
metaobject