Docs
RCSv4

Register the RCS brand

PUT/rcs/brand

Register the organization's RCS brand and send it for review, or resubmit a rejected or failed one with corrected details. Once it's submitted the brand can't change, except its point of contact through POST /rcs/brand/changes. registration.rcs_brand.updated fires as its status changes. OAuth apps need numbers:manage.

Headers

AuthorizationRequiredstring

Your API key, sent as a bearer token: Authorization: Bearer <api_key>. Editing this stays in sync with the API key box on the right.

Bearer

Body parameters

JSON
display_nameRequiredstring

The brand's name as people know it.

legal_nameRequiredstring

The registered legal name.

legal_entity_typeRequiredstring
"LIMITED_LIABILITY_COMPANY""CORPORATION""S_CORPORATION""PARTNERSHIP""SOLE_PROPRIETORSHIP"
organization_typeRequiredstring
"PRIVATE_PROFIT""PUBLIC_PROFIT""NON_PROFIT""GOVERNMENT"
websiteRequiredstring
einRequiredstring

US Employer Identification Number: nine digits, optionally NN-NNNNNNN.

stock_symboloptionalstring

Required for PUBLIC_PROFIT: the listing as EXCHANGE:SYMBOL.

streetRequiredstring
street2optionalstring
cityRequiredstring
stateRequiredstring
postal_codeRequiredstring
countryRequiredstring

ISO 3166-1 alpha-2 code.

first_nameRequiredstring

The brand's contact person.

last_nameRequiredstring
titleoptionalstring
emailRequiredstring
phoneRequiredstring

E.164.

Returns

dataoptionalRcsBrand
brand_idRequiredstring

Brand id (brand_...).

statusRequiredstring

Senders submit once the brand is verified. A draft, rejected, or failed brand can be registered again with PUT /rcs/brand.

"draft""submitting""in_review""verified""rejected""failed"
detailsRequiredRcsBrandDetails

The business behind the organization's RCS senders, as Google verifies it.

display_nameRequiredstring

The brand's name as people know it.

organization_typeRequiredstring
"PRIVATE_PROFIT""PUBLIC_PROFIT""NON_PROFIT""GOVERNMENT"
websiteRequiredstring
einRequiredstring

US Employer Identification Number: nine digits, optionally NN-NNNNNNN.

stock_symboloptionalstring

Required for PUBLIC_PROFIT: the listing as EXCHANGE:SYMBOL.

streetRequiredstring
street2optionalstring
cityRequiredstring
stateRequiredstring
postal_codeRequiredstring
countryRequiredstring

ISO 3166-1 alpha-2 code.

first_nameRequiredstring

The brand's contact person.

last_nameRequiredstring
titleoptionalstring
emailRequiredstring
phoneRequiredstring

E.164.

created_atRequiredinteger

Epoch ms.

updated_atRequiredinteger

Epoch ms.

Response codes

200The brand
400`missing_fields` (with the missing `fields`) or `invalid_field` (with the `field`).
401Your API key is missing or invalid. Pass it as a bearer token.
409`rcs_brand_submission_in_progress` (another submission is still running) or `rcs_brand_locked` (the brand is in review or verified, so it can't change; carries `brand_status`).
422`rcs_brand_rejected`: the registry refused the brand, with the rejected `fields` when it named them.
502`upstream_unavailable`: the RCS network couldn't be reached. Retry with backoff.

Sends a live request with your values and shows the real response below. Your key is stored only in this browser.

Request
curl -X PUT https://api.blooio.com/v4/rcs/brand \
Body object
Response objectexample
{  "data": {    "brand_id": "obj_a1b2c3d4",    "status": "draft",    "details": {      "display_name": "Jane Doe",      "legal_name": "string",      "legal_entity_type": "LIMITED_LIABILITY_COMPANY",      "organization_type": "PRIVATE_PROFIT",      "website": "https://example.com",      "ein": "12-3456789",      "stock_symbol": "NASDAQ:ACME",      "street": "string",      "street2": "string",      "city": "San Francisco",      "state": "active",      "postal_code": "94105",      "country": "US",      "first_name": "Jane",      "last_name": "Doe",      "title": "Example title",      "email": "jane@example.com",      "phone": "+15551234567"    },    "created_at": 0,    "updated_at": 0  }}