MyComm docs
Menu

Start

Getting started

What MyComm is, what you need before the first request, and where to go next.

What MyComm is#

MyComm is a messaging gateway. You send and receive messages through the phones and accounts you connect, instead of paying a provider per message. SMS through your own SIM cards is available today; other channels follow, and the API stays the same.

Four words cover most of the API:

Word Meaning
Account Your organisation. Everything below belongs to one account.
Channel One connected number or messaging account, for example a SIM in an Android phone.
Line What you send from and receive into, through one or more channels. Every account has a Direct line; you can add lines for your own integrations.
API key The secret your server sends in Authorization. A key can be limited to some lines.

The concepts page explains the rest.

What you need#

Step Result
Create an API key in the portal (Developers, API keys) You can authenticate requests.
Connect a phone (portal, or your own page) A channel that sends for the Direct line.
Send a message The API answers 202 and the message is queued.

Send your first message#

curl -sS -X POST https://mycomm.cogneer.tech/v1/messages \
  -H "Authorization: Bearer $MYCOMM_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: first-message-1" \
  -d '{
    "line_id": "LINE_ID",
    "to": "+923001234567",
    "body": "Hello from MyComm.",
    "category": "transactional"
  }'

GET /v1/lines lists your lines; every account has a Direct line that your verified numbers send for. A key limited to one line may leave line_id out. The send quickstart walks through each step and the answer.

Where to go next#