Overview
US carriers require a business and a texting campaign to be registered before a workspace can text from US numbers. In the Sendora app that is two screens. In the API it is one resource, SMS registrations, with atype of brand (your business) or campaign (what you text and how people opt in).
The order is always the same:
- Check readiness and, if you want, ask for a quote.
- Create a brand draft, then submit it.
- Create a campaign draft for that brand, then submit it.
- Attach your numbers to the campaign.
1. Check readiness and a quote
readiness (can you text yet, and next_step), options (the exact values the forms accept: entity_type such as company, sole_proprietor, nonprofit, government or public_company, vertical, use_case, opt_in_method and more) and, when you ask for one, a quote with total_due_now_cents. Use quote=campaign with use_case, or quote=vetting, for the other fees.
2. Create a brand draft
Send anIdempotency-Key of 8 to 255 characters, so a retry returns the same draft instead of making a second one.
type and entity_type. Use the values from options; a value that is not on the list answers 422. Fill the rest in with PATCH /sms-registrations/{id}, sending only the fields to change and type again. The response lists issues, the fields still missing or wrong, so you know what to fix before you submit.
3. Submit the brand
402 and nothing is submitted. Read state and status_text on the brand to follow its review. A sole proprietor brand also needs its phone code: action: "send_code", then action: "verify_code" with pin.
Other brand actions: vetting runs the optional paid trust check, and revet re-checks after you fix a problem.
4. Create and submit the campaign
{ "type": "campaign", "action": "submit" }. Other campaign actions: appeal (with reason) after a rejection, clone to copy a finished campaign into a new draft, attach_numbers (with phone_number_public_ids) and detach_number (with phone_number_public_id). Attaching numbers charges the wallet.
5. Read, follow and clean up
Assistants and the MCP
The Sendora MCP exposes the same steps. Reading and drafting areread_channels and edit_channels. The steps that charge the wallet (submit_sms_registration, request_sms_vetting, attach_sms_numbers) are in their own tool, run_channels, so an assistant has to ask for them on purpose. Read the quote and confirm with the person before it submits.