# register_site_message_business

Source: https://modulify.ai/docs/api/messages/register-site-message-business

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

- Title: Register the business for US texts
- Scope: `config:write`
- Access: Destructive
- Endpoint: `POST /v1/register_site_message_business`

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](https://modulify.ai/docs/built-in/messages#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.

> **Warning**
>
> This method is marked destructive: it deletes or overwrites data. Check the inputs before you call it, and send an [Idempotency-Key](https://modulify.ai/docs/api/idempotency) header whenever you might retry it.

```bash
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](https://modulify.ai/docs/mcp/messages/register-site-message-business).

## 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](https://modulify.ai/docs/api/requests-and-responses#the-response) 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](https://modulify.ai/docs/api/requests-and-responses#headers-on-every-method-call) 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](https://modulify.ai/docs/api/errors) explains every status code a call can answer with.