Skip to main content
This guide walks you through everything you need to send your first message with TGO Business. By the end you will have a verified sender number and a working API call that delivers a message to any recipient.
1

Create your workspace

Go to business.tgo-eg.com and register with your email address. After you submit the form, check your inbox for a verification email and click the confirmation link.Once your email is verified, complete your organization profile. This information is tied to your workspace and is required before you can create API keys or add sender numbers.
2

Generate an API key

In the dashboard, navigate to Access > API Keys and click New API key. Give the key a descriptive name and select the scopes it needs — for example, messages.send to send messages or usage.read to read usage data. Use * to grant all permissions.After creation, copy the key immediately. It is shown only once.Include the key on every Tenant API request using the X-Api-Key header:
X-Api-Key: tgo_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
3

Add a sender number

Navigate to Messaging > Sender Numbers and click New sender number. Enter the phone number you want to send messages from.TGO Business sends a one-time password to the TGO Connect account associated with that number. The person who owns the TGO Connect account must provide you with this OTP to complete verification.
The OTP is delivered inside the TGO Connect app, not by SMS. Make sure the phone number owner has TGO Connect installed and active.
4

Verify the sender number

Enter the OTP you received from the TGO Connect account owner in the verification prompt on the TGO Business dashboard. If the code is correct, the sender number status changes to active and it becomes available for sending.
If the TGO Connect account linked to the number has not been verified, the sender number will show a Needs account verification status. The TGO Connect account owner must complete their own account verification before you can verify the sender number.
5

Send your first message

With a verified sender number and a valid API key, you are ready to send a message. Replace {tenant-domain} with your workspace domain, and update sender_phone and to_phone with real numbers.
curl -X POST "https://{tenant-domain}/api/v1/messages" \
  -H "X-Api-Key: tgo_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "sender_phone": "+201001187188",
    "to_phone": "+201010000000",
    "type": "text",
    "content": "Hello from TGO Business"
  }'
A successful request returns a 201 response with the message ID and delivery status. You can use this ID to track the message later through the usage endpoints.

​
Next steps

Now that you have sent your first message, explore the rest of the platform:
  • Authentication — manage API keys and understand permission scopes.
  • Sender numbers — add more numbers or troubleshoot verification issues.
  • Messaging — learn about message types, delivery statuses, and error handling.