Zapier

Zapier connects thousands of web applications through automated workflows called Zaps. Use Blue webhooks and API requests to exchange data with Zapier. Blue webhook events can trigger Zaps in real time.

Example workflows

• Sync Blue records to Google Sheets: Append a row to a Google Sheet when a Blue record is created or updated.
• Send order confirmations from Blue records: Send a confirmation email when a specified Blue custom field is selected.
• Add Blue comments to Slack: Post Blue comment notifications to the relevant Slack channels.

Send Blue events to Zapier

Create a webhook in Blue

1. Log in to Blue.
2. Open Account > Webhooks.
3. Select Add Webhook.
4. Enter a webhook name.
5. Enter the Zapier webhook URL.
6. Select the events that must trigger the webhook.
7. Select Create Webhook.

Create the Zap

1. Log in to Zapier.
2. Select Make a Zap.
3. Select Webhooks by Zapier as the trigger application.
4. Configure the trigger to accept payloads from the Blue webhook URL.
5. Select the destination application for the second step.
6. Map the JSON payload fields to the destination fields.
7. Turn on the Zap.

When a selected event occurs, Blue sends its webhook payload to Zapier. Zapier then sends the mapped data to the destination application.

Send data from Zapier to Blue

Get Blue API credentials

1. Open Account > API.
2. Create a token or use existing credentials.
3. Copy the Token ID, Token Secret, Organization ID, and Workspace ID.

Create the Zap

1. Configure a trigger application, such as Google Sheets or Slack.
2. Add Webhooks by Zapier as the action app.
3. Select Custom Request as the event type.

Configure the request

• Method: POST
• URL: https://api.blue.app/graphql
• Data Pass-Through: FALSE
• Unflatten: NO

Set the headers

{
  "Content-Type": "application/json",
  "blue-token-id": "Your_Token_ID",
  "blue-token-secret": "Your_Token_Secret",
  "blue-org-id": "Your_Company_ID",
  "blue-workspace-id": "Your_Project_ID"
}

Configure the query

This example mutation creates a record:

{
  "query": "mutation CreateTodo($input: CreateTodoInput!) {\n  createTodo(input: $input) {\n    id\n    title\n    customFields {\n      value\n    }\n  }\n}",
  "variables": {
    "input": {
      "todoListId": "your-todo-list-id",
      "title": "New task from Zapier",
      "customFields": [
        {
          "customFieldId": "priority-field-id",
          "value": "High"
        },
        {
          "customFieldId": "due-date-field-id",
          "value": "2024-03-01"
        }
      ]
    }
  }
}

Test and activate the Zap

1. Test the mutation in the Blue API Playground.
2. Map dynamic values from the trigger application with Zapier data fields.
3. Enable the Zap after the test succeeds.