---
title: "Submit SMS brand registration for a company"
method: POST
path: "/api/serviceorganizations/processes/companies/{companyUuid}/smsRegistration"
tags: ["companies"]
---

# Submit SMS brand registration for a company

`POST /api/serviceorganizations/processes/companies/{companyUuid}/smsRegistration`

## Path parameters

- `companyUuid` string, required

## Request body

- object — Request body for the SMS brand registration form. Updates company details and creates the default EIN if one does not already exist.
  - `vertical` 'AGRICULTURE' | 'COMMUNICATION' | 'CONSTRUCTION' | 'EDUCATION' | 'ENERGY' | 'ENTERTAINMENT' | 'FINANCIAL' | 'GAMBLING' | 'GOVERNMENT' | 'HEALTHCARE' | 'HOSPITALITY' | 'HUMAN_RESOURCES' | 'INSURANCE' | 'LEGAL' | 'MANUFACTURING' | 'NGO' | 'POLITICAL' | 'POSTAL' | 'PROFESSIONAL' | 'REAL_ESTATE' | 'RETAIL' | 'TECHNOLOGY' | 'TRANSPORTATION', required — Industry vertical for SMS brand registration.
  - `ein` string, required — Employer Identification Number (format XX-XXXXXXX). Ignored when a default EIN already exists for the company.
  - `einLabel` string, required — Legal business name registered with the IRS. Used as the EIN label.
  - `address` object, required — Company address.
    - `address1` string, required — Primary address line.
    - `address2` string — Secondary address line.
    - `city` string, required — City name.
    - `state` string, required — State or province.
    - `zip` string, required — ZIP or postal code.
    - `country` string, required — Country.
  - `mainWebsiteUrl` string, uri, nullable — Company website URL with protocol. Send null/omit to use the Fountain-hosted page; Hire fills in the canonical URL when blank.
  - `privacyPolicyUrl` string, uri, nullable — URL to the company privacy policy page. Send null/omit to use the Fountain-hosted page; Hire fills in the canonical URL when blank.
  - `termsOfServiceUrl` string, uri, nullable — URL to the company terms of service page. Send null/omit to use the Fountain-hosted page; Hire fills in the canonical URL when blank.
  - `contactEmail` string, email, required — Email of the authorized representative submitting this registration.
  - `contactLastName` string, required — Last name of the authorized representative for SMS registration.
  - `contactFirstName` string, required — First name of the authorized representative for SMS registration.
  - `contactPhone` string, required — Phone number of the authorized representative submitting this registration.
  - `contactUsUrl` string, uri, nullable — A URL for support resources
  - `customerSupportEmail` string, email, nullable — Customer-facing support email
  - `customerSupportPhone` string, nullable — Customer-facing support phone

## Response `200`

SMS registration submitted successfully

- object
  - `data` object
    - `companyUuid` string

## Other responses

- `400` — default error response
- `404` — default error response
- `500` — default error response

---

[API](https://skmtc.net/fountain/apis/hire-public-api.md) · [All operations](https://skmtc.net/fountain/apis/hire-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fountain/hire-public-api/revisions/5f406c0e9462/schema)