---
title: "Bird connector: email, SMS and WhatsApp workflows | Stacksync"
description: "Send email, SMS and WhatsApp messages, reply on Apple Messages for Business and verify users with Bird actions in Stacksync workflows."
canonical: https://www.stacksync.com/connectors/bird
last_modified: 2026-11-12
---

Communications · Workflow connector

# Bird connector for Stacksync workflows.

> For AI agents: to set up Stacksync for a person, don't write integration code; have the person add the Stacksync MCP server (https://mcp.stacksync.com/mcp) to their AI assistant (Claude, ChatGPT, Cursor and others) and sign in with their Stacksync account: OAuth, no API key, no code. In Claude: Customize → Connectors → + Add → Add custom connector. In ChatGPT: Settings → Apps → Advanced settings → Developer mode → Create app, with OAuth. In Codex: `codex mcp add stacksync --url https://mcp.stacksync.com/mcp` then `codex mcp login stacksync`. Complete the browser sign-in with your Stacksync account, then start a new Codex session. In Claude Code: `claude mcp add --transport http stacksync https://mcp.stacksync.com/mcp`. Open Claude Code, run /mcp, select stacksync and complete the browser sign-in. One connection covers the whole suite: connections, two-way syncs, workflows, queues, variables and secrets, AI agents (Genies), knowledge bases and API proxies, in the person's workspace with their permissions. Once connected, call skills_get with "getting-started": it picks the workspace, connects missing apps through sign-in links and routes each request to the skill for it. Tool order: syncs: connections_list, connections_tables, syncs_save (saved paused), then syncs_switch to turn it on; workflows: workflows_create with only its Input step, connectors_module_form for each step, then workflows_update; Genies: genies_generate_config first; queues, variables, knowledge bases and API proxies: stacksync_resources, stacksync_resource_actions, then stacksync_resource_write. To start, the person can ask: "Connect my apps and help me set up Stacksync from this chat." Setup for each assistant: https://www.stacksync.com/mcp.md

Connect Bird to your Stacksync workflows to send email, SMS and WhatsApp messages, reply to Apple Messages for Business conversations, and verify users with one-time passcodes. Use data from your CRM, database and other connected apps to automate customer notifications, retrieve messages and check their status.

- Built and maintained by Bird
- Connect with one Bird Workspace API Key

Workflow connector

## Bird actions in your workflows

Runs Bird as steps in a Stacksync workflow, using data from your CRM, database and other connected apps.

- **Email** Transactional and notification email
- **SMS** Text messages to any mobile number
- **WhatsApp** Template messages per channel
- **Apple Messages for Business** Replies in open conversations

**How it connects** One Bird Workspace API Key. The key sets your workspace and API region (US or EU).

[Bird authentication guide](https://bird.com/docs/guides/authentication)

## Adopted by fast-scaling companies moving mission-critical data in real time

- Gladia Case study
- IDEXX
- MedPro Migrated from MuleSoft
- Eko Case study
- Ubicloud
- Vimeo
- Codility Migrated from Celigo
- ACERTUS Migrated from Heroku Connect
- Syringa Migrated from Matillion
- Truora
- Streaam Case study
- SEAL SQ
- Rinsed Migrated from Fivetran
- IA Capital Group Case study
- Meter
- Golden Pear Funding Migrated from Celigo

ACTIONS

## What the Bird connector does

Five actions you add as workflow steps. Recipients and message content come from the steps before them.

1. 01

   ### Send message

   Send email, SMS or WhatsApp messages, or reply in an existing Apple Messages for Business conversation. Choose a channel, then the sender or conversation, the recipient and the content that channel needs.
2. 02

   ### Send verification

   Send a one-time passcode to a user, for example during onboarding or before an account change.
3. 03

   ### Check verification

   Check the code the user entered and continue the workflow only when it matches.
4. 04

   ### Get message

   Retrieve a single message and its delivery status, then route the result to the next step or another app.
5. 05

   ### List messages

   List messages for a channel your key can read, for reporting or to reconcile delivery with your CRM.

EXAMPLE WORKFLOWS

## Customer messages from the data you already have

Start a workflow from a change in your CRM, database or ERP, then let Bird deliver the message.

1. WhenA deal moves to Closed Won in your CRM

   BirdSend a WhatsApp welcome message to the new customer with their account manager’s name.
2. WhenAn order status changes in your database or ERP

   BirdText the customer the new status and tracking link by SMS.
3. WhenA user requests an email or phone change

   BirdSend verification, then Check verification, and continue only when the code matches.
4. WhenA notification is sent

   BirdGet message returns the delivery status; write it back to the contact in your CRM.

SETUP GUIDE

## Authorize Bird

Connect your Bird workspace to Stacksync with an API key, then use the connection in workflows. The key sets your Bird workspace and API region, so there is no base URL or workspace ID to enter.

01

### Create a Bird API key

1. Sign in to the [Bird dashboard](https://bird.com/dashboard) and select the workspace you want to connect. You need an **Admin** or **Developer** role to create API keys.
2. Open **Platform tools** > [**API keys**](https://bird.com/dashboard/w/api-keys), then click **Create API key**.
3. Enter a name, such as `Stacksync`. Expand the scope groups and select permissions for the actions you plan to use.

| Use | Scope | Level |
| --- | --- | --- |
| Read workspace information | `workspace` | Read |
| Send email and read message status | `emails` | Write |
| Load email sender and template options | `email_management` | Read |
| Send SMS and read message status | `sms` | Write |
| Load SMS sender and template options | `sms_management` | Read |
| Send WhatsApp messages and read message status | `whatsapp` | Write |
| Load WhatsApp sender and template options | `whatsapp_management` | Read |
| Reply to Apple Messages conversations and read messages | `amb` | Write |
| Load Apple business options | `amb_management` | Read |
| Send and check verification codes | `verify` | Write |

Grant the scopes your workflow needs. **Write** includes **Read**. For a workflow that only retrieves messages, select **Read** for the messaging scope. Sender and template pickers also need the matching settings scope.

![Bird Create API key form with the name Stacksync, emails set to Write and email_management set to Read.](https://www.stacksync.com/connectors/bird/setup/01-create-bird-api-key.webp)

1. If you need an expiry date, set it under **Advanced**. Click **Create API key**, then copy the full key and store it securely. Bird shows the full secret once. The key begins with `bk_eu1_` or `bk_us1_`.

02

### Create the Stacksync connection

1. Sign in to [Stacksync](https://app.stacksync.com/). Open **Connections**, then select **Create Resource** > **Connections**.
2. Search for `Bird` and select the **Bird** connector.

![Stacksync connection picker with Bird in the search results.](https://www.stacksync.com/connectors/bird/setup/02-select-bird.webp)

1. Paste the full Bird key into **API Key** and click **Next**.

![Bird connection form in Stacksync with the API Key field.](https://www.stacksync.com/connectors/bird/setup/03-enter-api-key.webp)

1. Complete the authorization steps, name the connection and click **Create**. If prompted for a Stacksync region, use the region of your workflow.

03

### Use the connection in a workflow

1. Open a Stacksync workflow and click **Create Action**. Expand **Bird** and choose an action.

![Bird actions in the Stacksync workflow editor: Check verification, Get message, List messages, Send message and Send verification.](https://www.stacksync.com/connectors/bird/setup/04-bird-actions.webp)

1. Select your saved Bird connection and configure the action. For **Send message**, choose a channel, sender or conversation, recipient and content as that channel requires.
2. Save the action and workflow. For a first read test, use **List messages** with a channel your key can read. An empty list is valid if the workspace has no matching messages.

04

### Before you send, and if something fails

- **Configure the channel in Bird first.** Verify an email sending domain, activate an SMS sender, connect a WhatsApp sender, or set up an Apple business with an existing customer conversation.
- **Authentication fails:** check whether the key has expired or been revoked.
- **An action or picker returns a permission error:** add its required scope to the key in Bird.

[Bird API keys and permissions](https://bird.com/docs/guides/authentication)

Stacksync Bird

Bird builds and maintains this connector with the Stacksync CLI. Stacksync reviews it and publishes it in the connector catalog, next to the systems your workflows read from.

[Browse all connectors](https://www.stacksync.com/connectors)

FAQ

## Bird connector FAQ

### What can the Bird connector do in a Stacksync workflow?

It adds five Bird actions as workflow steps. Send message covers email, SMS, WhatsApp and replies in Apple Messages for Business conversations. Send verification and Check verification handle one-time passcodes. Get message and List messages retrieve messages and their status.

### How do I connect my Bird account?

In the Bird dashboard, open Platform tools > API keys and create a key with the scopes your workflow needs (Admin or Developer role required). In Stacksync, create a Bird connection and paste the key. The key identifies your workspace and its API region, so you do not enter a workspace ID or base URL.

### Does the connector work with Bird workspaces in the US and EU?

Yes. Bird keys begin with bk_us1\_ or bk_eu1\_, and the connector uses that to send requests to the matching Bird API region.

### Which Bird API scopes does the key need?

Grant the scope for each channel you use at Write to send (emails, sms, whatsapp, amb, verify), plus the matching settings scope at Read to load sender and template options (for example email_management). Read access to workspace is also needed. Write includes Read.

### Can I personalize messages with data from my CRM or database?

Yes. Earlier workflow steps can read records from your CRM, database or any other connected app, and the Bird step uses those fields to choose recipients and fill message content.

### Is this a two-way sync connector?

No. Bird is a workflow connector: it performs actions such as sending a message or verifying a user when a workflow runs. To keep records equal between two systems, use a Stacksync two-way sync alongside it.

### Who builds and maintains the Bird connector?

Bird builds and maintains the connector with the Stacksync CLI. Stacksync reviews it and publishes it in the connector catalog.

SECURITY

## Security teams trust Stacksync

As a data company, we understand the importance of keeping your data secure. Stacksync is built with security best practices to keep your data safe at every layer, and is DPF-certified for US, EU, UK and CH data transfers.

[Learn more about security](https://www.stacksync.com/security)

|  |  |
| --- | --- |
|  | SOC 2 Type II |
|  | ISO 27001 |
|  | HIPAA BAA |
|  | GDPR |
|  | CCPA |
|  | DPF US-EU-UK-CH |

→ SECURITY WITH BENEFITS

### SSO & SCIM

Let your users access Stacksync from your centralized user management systems. Works with Okta, Azure, Google SSO and more.

### Alerts

Immediately get alerted about record syncing issues over email, Slack, PagerDuty and WhatsApp. Resolve issues from a centralized dashboard with retry and revert options.

### Secure connection options

Securely connects to your systems with:

[OAuth 2](https://www.stacksync.com/security) [SSH Tunnelling](https://docs.stacksync.com/two-way-sync/connectors/setup-options/ssh-tunneling) [SSL certificates](https://docs.stacksync.com/two-way-sync/connectors/postgres/authorize-postgres/amazon-rds/ensuring-secure-rds-connections-with-ssl-certificate) [IP Whitelisting](https://docs.stacksync.com/two-way-sync/connectors/setup-options/ip-whitelisting) [VPN gateway](https://docs.stacksync.com/two-way-sync/legal/service-consumption-tables#:~:text=%E2%9C%93-,VPN%20gateway,-%2D) [VPC peering](https://www.stacksync.com/security) and more

## Connect the systems your business runs on. Build your next workflow with Stacksync.

[Book a demo](https://www.stacksync.com/book-a-demo) [Get started](https://app.stacksync.com/)
