Create an RCS sender
Registers a new RCS sender (agent) with the RCS platform and stores it on your account with status pending.
curl --request POST \
--url https://api.vobiz.ai/api/v1/sms/senders \
--header 'Content-Type: application/json' \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>' \
--data '
{
"provider": "YOUR_ROUTING_IDENTIFIER",
"senderName": "example-brand"
}
'from vobiz import Vobiz
client = Vobiz(api_key="MA_XXXXXXXX", auth_token="YOUR_AUTH_TOKEN")
from vobiz.sms import SenderBrand, SenderPhone, SenderEmail, SenderWebsite, SenderLink
client.sms.rcs_senders.create_sender(
provider="YOUR_ROUTING_IDENTIFIER",
sender_name="example-brand",
display_name="Example Brand",
description="Order updates and support for Example Brand customers.",
billing_category="CONVERSATIONAL",
use_case="TRANSACTIONAL",
hosting_region="NORTH_AMERICA",
brand=SenderBrand(
brand_name="Example Brand",
),
color="#1A73E8",
phones=[
SenderPhone(
phone_number="+14155550100",
label="Support",
)
],
emails=[
SenderEmail(
address="support@example.com",
label="Support",
)
],
websites=[
SenderWebsite(
url="https://example.com",
label="Website",
)
],
banner_url="https://example.com/rcs/banner.jpg",
logo_url="https://example.com/rcs/logo.png",
privacy=SenderLink(
url="https://example.com/privacy",
label="Privacy policy",
),
terms_of_service=SenderLink(
url="https://example.com/terms",
label="Terms of service",
),
)
const options = {
method: 'POST',
headers: {
'X-Auth-ID': '<api-key>',
'X-Auth-Token': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({provider: 'YOUR_ROUTING_IDENTIFIER', senderName: 'example-brand'})
};
fetch('https://api.vobiz.ai/api/v1/sms/senders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "7a1c3e5f-9b2d-4c6e-8f0a-1b3d5e7f9a21",
"accountId": "MA_XXXXXXXX",
"provider": "YOUR_ROUTING_IDENTIFIER",
"senderName": "example-brand",
"displayName": "Example Brand",
"description": "Order updates and support for Example Brand customers.",
"billingCategory": "CONVERSATIONAL",
"useCase": "TRANSACTIONAL",
"hostingRegion": "NORTH_AMERICA",
"status": "pending",
"brand": {
"brandName": "Example Brand"
},
"color": "#1A73E8",
"phones": [
{
"phoneNumber": "+14155550100",
"label": "Support"
}
],
"emails": [
{
"address": "support@example.com",
"label": "Support"
}
],
"websites": [
{
"url": "https://example.com",
"label": "Website"
}
],
"bannerUrl": "https://example.com/rcs/banner.jpg",
"logoUrl": "https://example.com/rcs/logo.png",
"privacy": {
"url": "https://example.com/privacy",
"label": "Privacy policy"
},
"termsOfService": {
"url": "https://example.com/terms",
"label": "Terms of service"
},
"createdAt": "2026-10-12T10:30:00Z",
"updatedAt": "2026-10-12T10:30:00Z"
}Authorizations
Your Vobiz account Auth ID (MA_XXXXXXXX).
Your Vobiz account Auth Token.
Body
The identity and profile of a new RCS sender. provider and senderName are required; the profile fields are what recipients see and what the RCS platform reviews.
The routing identifier your account was provisioned with for RCS. Contact support if you are unsure which value to use; an unknown value returns 400.
"YOUR_ROUTING_IDENTIFIER"
Unique technical name of the sender on the RCS platform. You pass it as from when you send RCS, and it cannot be changed later.
"example-brand"
The brand name recipients see at the top of the conversation.
"Example Brand"
Short description of your business or the sender's purpose, shown on the sender's info page.
"Order updates and support for Example Brand customers."
How the RCS platform bills conversations from this sender. Values accepted by the platform include CONVERSATIONAL and NON_CONVERSATIONAL.
"CONVERSATIONAL"
The kind of traffic the sender carries, reviewed by the RCS platform. Values accepted by the platform include OTP, TRANSACTIONAL, PROMOTIONAL and MULTI_USE.
"TRANSACTIONAL"
The region where the RCS platform hosts the sender. Values accepted by the platform include NORTH_AMERICA, EUROPE and ASIA_PACIFIC. Cannot be changed later.
"NORTH_AMERICA"
The brand the sender represents.
Show child attributes
Show child attributes
Accent colour for the sender's buttons and header, as a hex code such as #1A73E8.
"#1A73E8"
Contact phone numbers shown on the sender's info page, each with a label.
Show child attributes
Show child attributes
Contact email addresses shown on the sender's info page, each with a label.
Show child attributes
Show child attributes
Websites shown on the sender's info page, each with a label.
Show child attributes
Show child attributes
Publicly reachable HTTPS URL of the banner image shown at the top of the sender's info page.
"https://example.com/rcs/banner.jpg"
Publicly reachable HTTPS URL of the logo shown next to every message.
"https://example.com/rcs/logo.png"
Link to your privacy policy, shown on the sender's info page.
Show child attributes
Show child attributes
Link to your terms of service, shown on the sender's info page.
Show child attributes
Show child attributes
Identifiers the RCS platform has already assigned to your agent, if you have any.
Show child attributes
Show child attributes
Response
The new sender in status pending.
An RCS sender (agent): the verified brand identity that recipients see instead of a phone number. Send RCS from it by passing its senderName as from with channel: rcs.
Unique identifier of the sender on Vobiz (UUID). Use it in every /senders/{id} path.
"7a1c3e5f-9b2d-4c6e-8f0a-1b3d5e7f9a21"
Your Vobiz account ID (MA_...) that owns the sender.
"MA_XXXXXXXX"
Internal routing identifier; do not rely on its value.
"YOUR_ROUTING_IDENTIFIER"
Unique technical name of the sender on the RCS platform. Pass it as from when you send RCS. Fixed after creation.
"example-brand"
The brand name recipients see at the top of the conversation.
"Example Brand"
Short description shown on the sender's info page.
"Order updates and support for Example Brand customers."
How the RCS platform bills conversations from this sender, for example CONVERSATIONAL or NON_CONVERSATIONAL.
"CONVERSATIONAL"
The kind of traffic the sender carries, for example OTP, TRANSACTIONAL, PROMOTIONAL or MULTI_USE.
"TRANSACTIONAL"
The region where the RCS platform hosts the sender, for example NORTH_AMERICA, EUROPE or ASIA_PACIFIC. Fixed after creation.
"NORTH_AMERICA"
Launch status reported by the RCS platform, stored on your account. pending until the platform reports otherwise. Call GET /senders/{id}/status to refresh it.
"pending"
The brand the sender represents. Omitted when not set.
Show child attributes
Show child attributes
Accent colour as a hex code. Omitted when not set.
"#1A73E8"
Contact phone numbers shown on the sender's info page. Omitted when none are set.
Show child attributes
Show child attributes
Contact email addresses shown on the sender's info page. Omitted when none are set.
Show child attributes
Show child attributes
Websites shown on the sender's info page. Omitted when none are set.
Show child attributes
Show child attributes
HTTPS URL of the banner image. Omitted when not set.
"https://example.com/rcs/banner.jpg"
HTTPS URL of the logo image. Omitted when not set.
"https://example.com/rcs/logo.png"
Link to your privacy policy.
Show child attributes
Show child attributes
Link to your terms of service.
Show child attributes
Show child attributes
Identifiers the RCS platform assigned to your agent. Omitted when not set.
Show child attributes
Show child attributes
When the sender was created on your account (ISO 8601, UTC).
"2026-10-12T10:30:00Z"
When the sender last changed, including status refreshes (ISO 8601, UTC).
"2026-10-12T10:30:00Z"
Was this page helpful?
curl --request POST \
--url https://api.vobiz.ai/api/v1/sms/senders \
--header 'Content-Type: application/json' \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>' \
--data '
{
"provider": "YOUR_ROUTING_IDENTIFIER",
"senderName": "example-brand"
}
'from vobiz import Vobiz
client = Vobiz(api_key="MA_XXXXXXXX", auth_token="YOUR_AUTH_TOKEN")
from vobiz.sms import SenderBrand, SenderPhone, SenderEmail, SenderWebsite, SenderLink
client.sms.rcs_senders.create_sender(
provider="YOUR_ROUTING_IDENTIFIER",
sender_name="example-brand",
display_name="Example Brand",
description="Order updates and support for Example Brand customers.",
billing_category="CONVERSATIONAL",
use_case="TRANSACTIONAL",
hosting_region="NORTH_AMERICA",
brand=SenderBrand(
brand_name="Example Brand",
),
color="#1A73E8",
phones=[
SenderPhone(
phone_number="+14155550100",
label="Support",
)
],
emails=[
SenderEmail(
address="support@example.com",
label="Support",
)
],
websites=[
SenderWebsite(
url="https://example.com",
label="Website",
)
],
banner_url="https://example.com/rcs/banner.jpg",
logo_url="https://example.com/rcs/logo.png",
privacy=SenderLink(
url="https://example.com/privacy",
label="Privacy policy",
),
terms_of_service=SenderLink(
url="https://example.com/terms",
label="Terms of service",
),
)
const options = {
method: 'POST',
headers: {
'X-Auth-ID': '<api-key>',
'X-Auth-Token': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({provider: 'YOUR_ROUTING_IDENTIFIER', senderName: 'example-brand'})
};
fetch('https://api.vobiz.ai/api/v1/sms/senders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "7a1c3e5f-9b2d-4c6e-8f0a-1b3d5e7f9a21",
"accountId": "MA_XXXXXXXX",
"provider": "YOUR_ROUTING_IDENTIFIER",
"senderName": "example-brand",
"displayName": "Example Brand",
"description": "Order updates and support for Example Brand customers.",
"billingCategory": "CONVERSATIONAL",
"useCase": "TRANSACTIONAL",
"hostingRegion": "NORTH_AMERICA",
"status": "pending",
"brand": {
"brandName": "Example Brand"
},
"color": "#1A73E8",
"phones": [
{
"phoneNumber": "+14155550100",
"label": "Support"
}
],
"emails": [
{
"address": "support@example.com",
"label": "Support"
}
],
"websites": [
{
"url": "https://example.com",
"label": "Website"
}
],
"bannerUrl": "https://example.com/rcs/banner.jpg",
"logoUrl": "https://example.com/rcs/logo.png",
"privacy": {
"url": "https://example.com/privacy",
"label": "Privacy policy"
},
"termsOfService": {
"url": "https://example.com/terms",
"label": "Terms of service"
},
"createdAt": "2026-10-12T10:30:00Z",
"updatedAt": "2026-10-12T10:30:00Z"
}