Sign in
latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-201,3412,1385.0 MB

3fdc16374d70

RCS Brands

Create an RCS brand

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

post/rcs/brands

Request body

addressesobject required
display_namestring required
legal_entity_type'LIMITED_LIABILITY_COMPANY' | 'SOLE_PROPRIETORSHIP' | 'PARTNERSHIP' | 'CORPORATION' | 'S_CORPORATION' required
legal_namestring required
organization_type'PRIVATE_PROFIT' | 'PUBLIC_PROFIT' | 'NON_PROFIT' | 'GOVERNMENT' | 'UNKNOWN' required
profile_idstring nullable

A Messaging Profile owned by the authenticated organization. Agents inherit this value when they do not provide their own profile.

website_urlstring uri required

Example request

{
  "addresses": {
    "primary": {
      "administrative_area": "IL",
      "city": "Chicago",
      "country_code": "US",
      "line_1": "1 Main Street",
      "postal_code": "60601"
    }
  },
  "contacts": {
    "brand": {
      "contact_type": "BRAND",
      "email": "jane@example.com",
      "first_name": "Jane",
      "last_name": "Doe",
      "phone_number": "+13125550100",
      "title": "Messaging Operations Manager"
    }
  },
  "display_name": "Acme",
  "identifiers": {
    "ein": {
      "identifier_type": "EIN",
      "value": "12-3456789"
    }
  },
  "legal_entity_type": "LIMITED_LIABILITY_COMPANY",
  "legal_name": "Acme LLC",
  "organization_type": "PRIVATE_PROFIT",
  "profile_id": "40000000-0000-0000-0000-000000000001",
  "website_url": "https://www.example.com"
}

Response

The brand draft was created.

addressesobject required
brand_idstring uuid required
contactsobject required
display_namestring required
identifiersobject required
legal_entity_typestring required
legal_namestring required
organization_typestring required
profile_idstring nullable required
status'CREATED' | 'CONFIGURED' | 'SUBMITTED' | 'REVIEWING' | 'VETTING' | 'VERIFIED' | 'REJECTED' | 'FAILED' required
website_urlstring uri required

Example response

{
  "addresses": {
    "primary": {
      "administrative_area": "IL",
      "city": "Chicago",
      "country_code": "US",
      "line_1": "1 Main Street",
      "postal_code": "60601"
    }
  },
  "brand_id": "11111111-1111-4111-8111-111111111111",
  "capabilities": {
    "brand_entity": true,
    "brand_verification": true,
    "campaigns": false,
    "distinct_launch_phase": false,
    "invite_test_devices": false,
    "per_carrier_approval": false,
    "submission_sections": true,
    "templates": false,
    "vendor_webhooks": false
  },
  "contacts": {
    "brand": {
      "contact_type": "BRAND",
      "email": "jane@example.com",
      "first_name": "Jane",
      "last_name": "Doe",
      "phone_number": "+13125550100",
      "title": "Messaging Operations Manager"
    }
  },
  "display_name": "Acme",
  "identifiers": {
    "ein": {
      "identifier_type": "EIN",
      "value": "12-3456789"
    }
  },
  "legal_entity_type": "LIMITED_LIABILITY_COMPANY",
  "legal_name": "Acme LLC",
  "organization_type": "PRIVATE_PROFIT",
  "profile_id": "40000000-0000-0000-0000-000000000001",
  "status": "CREATED",
  "website_url": "https://www.example.com"
}