Connect messaging channels

Origamy sends messages through channels — Email, SMS, WhatsApp, Push, Slack, In-app, and Webhook. Each channel is powered by a provider you connect once per workspace: either with a single click (OAuth, where the provider supports it) or by pasting credentials from the provider’s console.

A few things are true for every provider on this page:

• Credentials are encrypted at rest and pushed to your data plane within seconds of saving — no redeploy, no waiting.
• Right after you connect, Origamy probes the provider with your real credentials and tells you immediately if something is wrong, instead of letting the first production send fail.
• You can connect several providers per channel and change the default at any time under Channels.

To connect anything below, go to Channels in the dashboard, pick the channel, and choose Connect provider.

Slack

The fastest connection in the product — no Slack app to create, no token to copy.

Add to Slack (recommended)

1. In Channels → Slack → Connect provider, choose Slack.

2. Click Add to Slack. A Slack window opens asking you to pick your Slack workspace and approve the Origamy bot.

3. Approve. The window closes, the dashboard shows Slack workspace authorized, and you’re done. Optionally set a Default channel (like #alerts) for messages that don’t specify one.

The bot can post to any public channel right away. For private channels, invite it first with /invite @Origamy.

Note

Your bot token never passes through the browser — the authorization is exchanged server-side and stored encrypted.

Paste a bot token

If you prefer your own Slack app (or your Origamy control plane doesn’t have Slack OAuth configured), create one at api.slack.com/apps:

1. Create New App → From scratch, pick your workspace.
2. Under OAuth & Permissions, add the bot scopes chat:write, chat:write.public, and channels:read, then Install to Workspace.
3. Copy the Bot User OAuth Token (starts with xoxb-) into the Origamy form.

Without chat:write.public, you must /invite the bot into every channel it posts to.

Email

Connect any one of these — Origamy renders the message; your provider delivers it.

Provider	You’ll need	Where to find it
SendGrid	API key, default from address	Settings → API Keys (needs Mail Send permission). The from address must be a verified sender or authenticated domain.
Cloudflare Email	Account ID, API token, default from address	Cloudflare dashboard → Account Home (ID) and My Profile → API Tokens.
Postmark	Server token, message stream	Servers → API Tokens; stream defaults to outbound.
Mailgun	API key, sending domain, region (us/eu)	Settings → API Keys. Region must match where your domain is hosted.

Caution

The default from address must be verified with your provider before connecting — an unverified sender is the most common reason the post-connect credential check fails.

SMS — Twilio

You’ll need your Account SID and Auth Token (both on the Twilio Console home page) and a default sender: either an SMS-capable Twilio number in E.164 format (+15551234567) or a Messaging Service SID (MG…) if you use one.

WhatsApp

Two ways to send WhatsApp messages:

Twilio WhatsApp

Same Account SID and Auth Token as SMS, plus your WhatsApp-enabled number in Twilio’s whatsapp:+15551234567 format. Quickest if you already use Twilio; Twilio’s WhatsApp sandbox also works for testing.

Meta WhatsApp Cloud API

If your dashboard shows Connect WhatsApp with Facebook, use it — Meta’s guided signup creates or links your WhatsApp Business account, connects your number, and sets up delivery reports in one popup, with no tokens to copy. The manual path below is the fallback.

To connect manually, from your Meta developer app with WhatsApp added:

• Phone number ID and WhatsApp Business Account ID — WhatsApp → API Setup.
• Access token — use a permanent System User token (Business Settings → System Users), not the 24-hour temporary token from API Setup.

To also receive replies (delivery reports and inbound messages), fill the optional Verify token (any secret string you choose) and App secret (App Settings → Basic), then register the callback URL shown in the provider form in Meta’s WhatsApp → Configuration → Webhooks.

Push

Provider	You’ll need
Firebase (FCM)	Firebase project ID + a service-account JSON key (Project Settings → Service accounts → Generate new private key).
Apple (APNs)	An APNs Auth Key (.p8), its Key ID, your Team ID, the app bundle ID, and the environment (sandbox/production).
OneSignal	App ID + REST API key (Settings → Keys & IDs).

Webhook

Point a channel at any HTTPS endpoint you run: set the URL, the method, and an optional signing secret Origamy uses to sign each delivery so your endpoint can verify it came from us.

After connecting

• The channel shows Connected with the provider name; sends from broadcasts, journeys, and the API route through it immediately.
• Each channel has one default provider; connect more and switch defaults under Channels without touching your messages.
• Rotate credentials any time by editing the provider — the update reaches the data plane in seconds.

Self-hosting?

One-click OAuth buttons (Slack today, more coming) appear when your control plane has the provider’s OAuth app configured — see the SLACK_OAUTH_* variables in the self-hosting guide. Without them, every provider still connects via credentials.