> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatsyncs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How Do I Connect a Custom SMS Gateway via HTTP GET with ChatSyncs?

> Connect an SMS provider that isn't natively listed in SMS Integration, using its HTTP GET endpoint and the PHONE/MESSAGE placeholders ChatSyncs fills in automatically. Use when a customer's SMS gateway (regional, niche, or in-house) only exposes a URL-based API.

[SMS Integration](/learn/chatsyncs-integrations/sms/introduction) lists **HTTP GET** alongside the named providers — pick
it when your SMS gateway isn't natively supported but exposes a simple URL you can call to send a
message. This covers regional or niche gateways, and in-house/proprietary SMS systems.

## Step 1: Add a new SMS profile

From [SMS Integration](/learn/chatsyncs-integrations/sms/introduction), click **New**.

<Frame>
  <img src="https://mintcdn.com/chatsyncs/sAsjFfzcUITpKpey/images/learn/sms-http-get-custom-gateway/step-01-chatsyncs-sms-api-nav.png?fit=max&auto=format&n=sAsjFfzcUITpKpey&q=85&s=811feea8a8ac8dda83dbee71a07ed080" alt="ChatSyncs Settings & Integration page with API Integration selected, SMS API highlighted, and the New button highlighted" width="1872" height="803" data-path="images/learn/sms-http-get-custom-gateway/step-01-chatsyncs-sms-api-nav.png" />
</Frame>

## Step 2: Choose HTTP GET and provide the API details

Select **Http Get** from the provider list on the right. You'll see a small notice confirming
this option "only supports HTTP GET request" — that just means the gateway you're connecting
must let you send an SMS by visiting a URL, the same way opening a link in your browser works.

Enter a custom **API Name** for your own reference (it's just a label so you can find this
profile again later), and paste your gateway's **HTTP GET request URL** into the URL field — a
fully functional URL that already includes the query parameters your provider requires (phone
number, message, API key, etc.).

<Frame>
  <img src="https://mintcdn.com/chatsyncs/sAsjFfzcUITpKpey/images/learn/sms-http-get-custom-gateway/step-02-http-get-form.png?fit=max&auto=format&n=sAsjFfzcUITpKpey&q=85&s=4f41cd88412fdf79ab6fce0922851faf" alt="SMS API modal with Http Get selected in the provider list, a notice that Custom API only supports HTTP GET request, an API Name field, an HTTP URL field, and an Analyze and test call button" width="796" height="818" data-path="images/learn/sms-http-get-custom-gateway/step-02-http-get-form.png" />
</Frame>

Use the placeholders **PHONE** and **MESSAGE** anywhere in the URL where the recipient's number
and message text belong, for example:

```text theme={null}
https://api.example.com/sendSMS?apiKey=YOUR_API_KEY&to=PHONE&msg=MESSAGE
```

ChatSyncs swaps `PHONE` and `MESSAGE` for the real recipient number and message text every time
it actually sends a message through this profile — you never edit the URL again after saving it.

## Step 3: Test and save

Click **Analyze and test call** to confirm the URL works, then click **Save** to store the
profile.

<Warning>
  Make sure your gateway's endpoint actually supports **GET** requests, and that any query
  parameters are properly URL-encoded. Some gateways also require **IP whitelisting** — check with
  your provider if the test call fails.
</Warning>

## Frequently asked

<AccordionGroup>
  <Accordion title="How do I connect an SMS gateway that isn't in the SMS Integration list?">
    Add a new SMS profile, choose **Http Get** as the provider, and paste your gateway's HTTP GET
    URL — including the `PHONE` and `MESSAGE` placeholders — into the URL field.
  </Accordion>

  <Accordion title="What do the PHONE and MESSAGE placeholders do?">
    They mark where the recipient's number and the message text belong in your gateway's URL.
    ChatSyncs replaces them with the real values every time it sends an SMS through that profile.
  </Accordion>

  <Accordion title="How do I know if my custom gateway URL is working before I save it?">
    Use the **Analyze and test call** button after entering the URL — it verifies ChatSyncs can
    actually reach and use your gateway before you save the profile.
  </Accordion>
</AccordionGroup>

## Related Documentation

* [SMS Integration](/learn/chatsyncs-integrations/sms/introduction) — connecting any SMS gateway and what it's used for.
