Getting Started with TextGrid

Use the TextGrid API to send SMS and MMS messages, manage phone numbers, make voice calls, and register 10DLC brands and campaigns.

Get your credentials

Find your Account SID and Auth Token in your TextGrid account dashboard.

Keep these credentials private. Make API requests from your server rather than exposing credentials in browser or mobile application code.

Authenticate your requests

Join your Account SID and Auth Token with a colon:

YOUR_ACCOUNT_SID:YOUR_AUTH_TOKEN

Base64-encode that string and send the result in the Authorization header:

Authorization: Bearer YOUR_BASE64_ENCODED_CREDENTIALS

Make your first request

Retrieve your account details:

curl "https://api.textgrid.com/2010-04-01/Accounts/YOUR_ACCOUNT_SID.json" \
  -H "Authorization: Bearer YOUR_BASE64_ENCODED_CREDENTIALS"

Replace both placeholders with your account’s values.

Explore the API

Open API Reference in the navigation to browse endpoints, request fields, response schemas, and examples.

Most operations use this base URL:

https://api.textgrid.com/2010-04-01

Phone number lookups use:

https://lookups.textgrid.com/v1

Use the content type shown for each endpoint. Some operations accept JSON, while others use form fields or query parameters.

Receive webhooks

Configure callback URLs to receive incoming messages, delivery updates, and voice events.

Your callback endpoints must be reachable by TextGrid. Verify the X-TextGrid-Signature header using your account’s Webhook Secret.

Register messaging traffic

For messaging that requires 10DLC registration:

1. Create a brand.
2. Complete verification and any required vetting.
3. Register a campaign.
4. Attach your sending numbers to the campaign.

The API Reference includes the endpoints for each step.