---
title: "Create an RCS brand"
method: POST
path: "/rcs/brands"
tags: ["RCS Brands"]
---

# Create an RCS brand

`POST /rcs/brands`

Creates an editable RCS brand draft. Creating the draft does not begin external review.

## Request body

- BrandCreateRequest
  - `addresses` object, required
  - `contacts` BrandContacts, required — Named business contacts. Use the `brand` key for the required BRAND contact.
    - `brand` object, required
      - `contact_type` 'BRAND', required
      - `email` string, email, required
      - `first_name` string, required
      - `last_name` string, required
      - `phone_number` string, required
      - `title` string, nullable
  - `display_name` string, required
  - `identifiers` BrandIdentifiers, required — Named business identifiers. Use the `ein` key for the required EIN and `stock_symbol` for a public-profit brand's stock symbol.
    - `ein` EinBrandIdentifier, required
      - `identifier_type` 'EIN', required
      - `value` string, required — Nine digits, optionally formatted as NN-NNNNNNN.
    - `stock_symbol` StockSymbolBrandIdentifier
      - `identifier_type` 'STOCK_SYMBOL', required
      - `value` string, required — A stock symbol using EXCHANGE:SYMBOL.
  - `legal_entity_type` 'LIMITED_LIABILITY_COMPANY' | 'SOLE_PROPRIETORSHIP' | 'PARTNERSHIP' | 'CORPORATION' | 'S_CORPORATION', required
  - `legal_name` string, required
  - `organization_type` 'PRIVATE_PROFIT' | 'PUBLIC_PROFIT' | 'NON_PROFIT' | 'GOVERNMENT' | 'UNKNOWN', required
  - `profile_id` string, nullable — A Messaging Profile owned by the authenticated organization. Agents inherit this value when they do not provide their own profile.
  - `website_url` string, uri, required

## Response `201`

The brand draft was created.

- BrandResponse
  - `addresses` object, required
  - `brand_id` string, uuid, required
  - `capabilities` CapabilitiesResponse, required
    - `brand_entity` boolean, required
    - `brand_verification` boolean, required
    - `campaigns` boolean, required
    - `distinct_launch_phase` boolean, required
    - `invite_test_devices` boolean, required
    - `per_carrier_approval` boolean, required
    - `submission_sections` boolean, required
    - `templates` boolean, required
    - `vendor_webhooks` boolean, required
  - `contacts` object, required
  - `display_name` string, required
  - `identifiers` object, required
  - `legal_entity_type` string, required
  - `legal_name` string, required
  - `organization_type` string, required
  - `profile_id` string, nullable, required
  - `status` 'CREATED' | 'CONFIGURED' | 'SUBMITTED' | 'REVIEWING' | 'VETTING' | 'VERIFIED' | 'REJECTED' | 'FAILED', required
  - `website_url` string, uri, required

## Other responses

- `401` — The request is not authenticated.
- `409` — The operation is not allowed in the current lifecycle state or the idempotency key was used for a different request.
- `422` — The request body or parameters failed validation.
- `503` — A registration dependency is temporarily unavailable.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/3fdc16374d70/schema)
