Register the business for US texts

register_site_message_business

Sends a site's business details to US carriers so the site can text people in the United States.

POST /v1/register_site_message_businessScopeconfig:writeDestructive

It files legal business details, so the tool tells the client to ask you for every value, read them back and pass confirmed only once you confirm they are correct and that people agree before the site texts them. A person without a company registers as SOLE_PROPRIETOR with their full legal name. Modulify adds the rest from the site: its texting privacy page and terms, sample texts from its approved templates, of which at least one must be approved, and the STOP and HELP replies. US carriers usually answer in 3 to 7 business days, then the site gets its own US number. It is refused until the site is published, because carriers check the live site, and while a registration is in review or already approved, and it needs the Delete projects permission. See US texting.

Request

Call it with a POST to https://api.modulify.ai/v1/register_site_message_business, sending the inputs below as a JSON object. The token needs the config:write scope.

This method is marked destructive: it deletes or overwrites data. Check the inputs before you call it, and send an Idempotency-Key header whenever you might retry it.

curl -X POST https://api.modulify.ai/v1/register_site_message_business \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"PROJECT_ID","entityType":"ENTITY_TYPE","legalName":"LEGAL_NAME","businessName":"BUSINESS_NAME","taxId":"TAX_ID","street":"STREET","city":"CITY","state":"STATE","postalCode":"POSTAL_CODE","contactName":"CONTACT_NAME","contactEmail":"CONTACT_EMAIL","contactPhone":"CONTACT_PHONE","messageFlow":"MESSAGE_FLOW","confirmed":true}'

Over MCP, the same method is the register_site_message_business tool.

Inputs

Input Type Required Description
projectId string Yes The site id.
entityType string Yes The kind of business: PRIVATE_PROFIT for a company, SOLE_PROPRIETOR for a person without one, NON_PROFIT, PUBLIC_PROFIT for a listed company, or GOVERNMENT.
legalName string Yes The legal name on the tax records. A sole proprietor gives their full legal name.
businessName string Yes The name people know the business by, usually the site's name.
taxId string Yes The 9 digit US tax ID (EIN), such as 12-3456789.
street string Yes The street address on the tax records.
city string Yes The city.
state string Yes The two letter US state, such as CA.
postalCode string Yes The 5 digit ZIP code.
website string No The business website. Leave it out to use the site's primary address.
contactName string Yes The person carriers can contact.
contactEmail string Yes Their email.
contactPhone string Yes Their phone in international format, such as +14155550100.
messageFlow string Yes How people agree to get the site's texts, at least 40 characters.
confirmed boolean Yes True once you confirmed every detail is correct and that people agree before the site texts them.

Response

Every call answers with the JSON envelope of success, message, data, code and version. data holds the result described above, and on a method that returns a total, count carries it. The response headers carry the call's X-Request-Id and what is left of your per-minute budget in X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Errors explains every status code a call can answer with.