{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Create a sender and submit its initial registration.\n\nA 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.<br><br>*Rate limits*:<br>Burst: `1/s`<br>Steady: `15/m`\n\n**Scopes:**\n`sender-config:write`\n\n[OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/create_text_messaging_sender.json)","properties":{"query":{"type":"object","properties":{"fields[text-messaging-sender-registration]":{"type":"array","items":{"type":"string","enum":["created_at","decided_at","failures","id","status","submitted_at","updated_at"]},"description":"For more information please visit https://developers.klaviyo.com/en/v2026-10-15/reference/api-overview#sparse-fieldsets"},"fields[text-messaging-sender]":{"type":"array","items":{"type":"string","enum":["created_at","forwarding_number","id","sender_details","sender_details.country","sender_identifier","sender_type","status"]},"description":"For more information please visit https://developers.klaviyo.com/en/v2026-10-15/reference/api-overview#sparse-fieldsets"},"include":{"type":"array","items":{"type":"string","enum":["text-messaging-sender-registration"]},"description":"For more information please visit https://developers.klaviyo.com/en/v2026-10-15/reference/api-overview#relationships"}},"required":[],"additionalProperties":false},"headers":{"type":"object","properties":{"revision":{"type":"string","default":"2026-10-15","enum":["2026-10-15"],"description":"API endpoint revision (format: YYYY-MM-DD[.suffix])"}},"required":["revision"],"additionalProperties":false},"body":{"$ref":"#/definitions/TextMessagingSenderCreateQuery"}},"required":["headers","body"],"additionalProperties":false,"definitions":{"TextMessagingSenderCreateQuery":{"type":"object","properties":{"data":{"$ref":"#/definitions/TextMessagingSenderCreateQueryResourceObject"}},"required":["data"]},"TextMessagingSenderCreateQueryResourceObject":{"type":"object","properties":{"type":{"$ref":"#/definitions/TextMessagingSenderEnum"},"attributes":{"type":"object","properties":{"sender_type":{"description":"The kind of sender to create. Must be `toll_free` in v1.","type":"string","enum":["alpha","long_code","short_code","toll_free","vanity_short_code"]},"sender_details":{"$ref":"#/definitions/TollFreeSenderDetails"},"text-messaging-sender-registration":{"description":"Toll-free verification submitted with the new sender.","type":"object","properties":{"data":{"$ref":"#/definitions/TollFreeRegistrationDetailsResourceObject"}},"required":["data"]},"forwarding_number":{"description":"E.164 phone number to forward inbound voice calls to. Optional.","type":["string","null"],"examples":["+15557654321"]}},"required":["sender_type","sender_details","text-messaging-sender-registration"]}},"required":["type","attributes"]},"TextMessagingSenderEnum":{"type":"string","enum":["text-messaging-sender"]},"TollFreeSenderDetails":{"type":"object","properties":{"country":{"description":"ISO 3166-1 alpha-2 country code for the sender. Supported values: `US` and `CA`.","type":"string","enum":["CA","US"],"examples":["US"]}},"required":["country"]},"TollFreeRegistrationDetailsResourceObject":{"type":"object","properties":{"type":{"$ref":"#/definitions/TextMessagingSenderRegistrationEnum"},"attributes":{"type":"object","properties":{"first_name":{"description":"Contact first name.","type":"string","examples":["Jane"]},"last_name":{"description":"Contact last name.","type":"string","examples":["Doe"]},"phone_number":{"description":"Contact phone number in E.164 format.","type":"string","examples":["+15551234567"]},"email":{"description":"Contact email address.","type":"string","examples":["jane@example.com"]},"address":{"$ref":"#/definitions/Address"},"business_type":{"description":"Legal structure of the business.","type":"string","enum":["GOVERNMENT","NON_PROFIT","PRIVATE_PROFIT","PUBLIC_PROFIT","SOLE_PROPRIETOR"]},"business_name":{"description":"Legal business name.","type":"string","examples":["Acme Corp"]},"business_website":{"description":"Public website URL for the business.","type":"string","examples":["https://acme.example.com"]},"doing_business_as":{"description":"DBA name if different from the legal business name.","type":["string","null"]},"business_registration_country":{"description":"ISO 3166-1 alpha-2 country in which the business is registered. Required for all businesses; must be `US` for a sole proprietor omitting the registration authority and number.","type":["string","null"],"examples":["US"]},"business_registration_authority":{"description":"Authority that issued the business registration number. Required unless the business is a US sole proprietor without a registration number.","type":["string","null"],"enum":["ABN","ACN","BRN","CBN","CIF","CNPJ","CRN","EIN","NEQ","NIF","NZBN","OTHER","PROVINCIAL_NUMBER","SIREN","SIRET","UID","USt-IdNr","VAT"]},"business_registration_number":{"description":"Business registration number. Required unless the business is a US sole proprietor.","type":["string","null"]},"privacy_policy_url":{"description":"Public URL of the business's privacy policy.","type":["string","null"],"examples":["https://acme.example.com/privacy"]},"terms_of_service_url":{"description":"Public URL of the business's terms of service.","type":["string","null"],"examples":["https://acme.example.com/terms"]}},"required":["first_name","last_name","phone_number","email","address","business_type","business_name","business_website"]}},"required":["type","attributes"]},"TextMessagingSenderRegistrationEnum":{"type":"string","enum":["text-messaging-sender-registration"]},"Address":{"type":"object","properties":{"street_address_1":{"description":"Street address line 1.","type":"string","examples":["125 Summer Street"]},"city":{"description":"City.","type":"string","examples":["Boston"]},"region":{"description":"State, province, or region.","type":"string","examples":["MA"]},"postal_code":{"description":"Postal code.","type":"string","examples":["02110"]},"country":{"description":"ISO 3166-1 alpha-2 country code for the business address.","type":"string","examples":["US"]},"street_address_2":{"description":"Street address line 2.","type":["string","null"],"examples":["Suite 400"]}},"required":["street_address_1","city","region","postal_code","country"]}}},"name":"Create Text Messaging Sender","id":"klaviyo.create_text_messaging_sender","example":{"headers":{"revision":"2026-10-15"},"body":{"data":{"type":"text-messaging-sender","attributes":{"sender_type":"alpha","sender_details":{"country":"US"},"text-messaging-sender-registration":{"data":{"type":"text-messaging-sender-registration","attributes":{"first_name":"Jane","last_name":"Doe","phone_number":"+15551234567","email":"jane@example.com","address":{"street_address_1":"125 Summer Street","city":"Boston","region":"MA","postal_code":"02110","country":"US"},"business_type":"GOVERNMENT","business_name":"Acme Corp","business_website":"https://acme.example.com"}}}}}}},"maxRequests":1,"summary":false}}