Skip to main content
A sender number represents the TGO Connect account that appears as the sender when your organization sends messages to recipients. Before you can send any messages through the TGO Business API, you must register at least one sender number and confirm that your organization has permission to use it.

​
Sender number statuses

Each sender number moves through a set of statuses as it is registered, verified, and used.
StatusMeaning
pending_verificationThe number has been created and is waiting for OTP confirmation.
activeOTP has been accepted. The number is usable if the associated TGO Connect account is also verified.
pending_account_verificationOTP was accepted, but the TGO Connect account owner still needs to complete account verification.
rejectedThe number has been rejected and cannot be used for sending.

​
Add and verify a sender number

1

Register the number

Send a POST request to /api/v1/sender-numbers with the phone number and an optional display name. The API key used must have the messages.send scope.
curl -X POST "https://{tenant-domain}/api/v1/sender-numbers" \
  -H "X-Api-Key: {api_key}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"phone": "+201001187188", "display_name": "Support"}'
After the request succeeds, the number is created with status pending_verification.
2

Deliver the OTP

TGO Business sends a one-time password (OTP) to the TGO Connect account that owns the registered phone number. The OTP arrives as a message inside TGO Connect.
3

Enter the OTP in TGO Business

The number owner opens the TGO Business dashboard, locates the pending sender number, and enters the OTP they received. Once the OTP is accepted, the number moves to active (or pending_account_verification if the TGO Connect account still requires verification).
If the TGO Connect account associated with the number has not been verified, the sender number status becomes pending_account_verification after OTP confirmation. No new OTP is required — the owner only needs to complete account verification in TGO Connect. See Account Verification for details.

​
List sender numbers

Retrieve all sender numbers registered to your organization: 
curl "https://{tenant-domain}/api/v1/sender-numbers" \
  -H "X-Api-Key: {api_key}" \
  -H "Accept: application/json"
The response includes each number’s id, phone, display_name, status, and verification_status. Use the id or phone to identify the sender when sending messages.