Customer.io Integration

Field	Description	Required	Format
Site ID	Your Customer.io Site ID (Settings > Workspace Settings > API Credentials)	No	`xxxxxxxx-xxxx-xxxx`
API Key	Your Customer.io Tracking API Key (Settings > Workspace Settings > API Credentials)	Yes	`xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`
Region	Customer.io data region: ‘US’ (default, track.customer.io) or ‘EU’ (track-eu.customer.io). Must match the workspace’s region.	No	`US`

create_or_update_customer — Creates a new customer profile or updates an existing one in Customer.io

Parameters

string

required

The unique identifier for the customer

string

required

The customer’s email address

integer

UNIX timestamp from when the user was created in your system

object

Custom attributes (name, plan, company, etc.)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "message": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Message"
    },
    "customer_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Customer Id"
    },
    "email": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Email"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateOrUpdateCustomerOutput",
  "type": "object"
}

send_event — Sends a tracking event to a customer for triggering campaigns and segmentation

Parameters

string

required

The unique identifier for the customer

string

required

The name of the event to track

string

Event type modifier (set to ‘page’ for page views)

object

Custom data to include with the event

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "message": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Message"
    },
    "customer_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Customer Id"
    },
    "event_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Event Name"
    }
  },
  "required": [
    "success"
  ],
  "title": "SendEventOutput",
  "type": "object"
}

add_customers_to_segment — Adds customers to a manual segment by their IDs (max 1000 per request)

Parameters

string

required

The segment ID

array

required

List of customer IDs (max 1000)

string

The type of IDs: ‘id’, ‘email’, or ‘cio_id’ (Default: id)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "message": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Message"
    },
    "segment_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Segment Id"
    },
    "customer_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Customer Count"
    },
    "id_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Id Type"
    }
  },
  "required": [
    "success"
  ],
  "title": "AddCustomersToSegmentOutput",
  "type": "object"
}

Using

Providers

Building

Tools

Customer.io Integration for AI Agents & Workflows

Overview

Authentication

API Key Authentication

Required Credentials

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Klaviyo

Mailchimp

Pinterest

Links

​Overview

​Authentication

​API Key Authentication

​Required Credentials

​Available Actions

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Limits & Quotas

​Related integrations

Klaviyo

Mailchimp

Pinterest

​Links

Overview

Authentication

API Key Authentication

Required Credentials

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Related integrations

Links