---
title: "Create Email integration"
method: POST
path: "/integration/email/create"
tags: ["Email Integration"]
---

# Create Email integration

`POST /integration/email/create`

## Request

- Base URL: `https://api.chatbotkit.com/api/v1`
- URL: `https://api.chatbotkit.com/api/v1/integration/email/create`
- Auth: HTTP bearer

## Request body

- object: A bot configuration that can be applied without a dedicated bot instance.
  - `alias` string, nullable: The unique alias for the instance
  - `name` string: The associated name
  - `description` string: The associated description
  - `meta` Meta: Meta data information
  - `blueprintId` string, nullable: The ID of the blueprint
  - `botId` string, nullable: The ID of the bot this configuration is using
  - `contactCollection` boolean: Weather to collect contacts
  - `sessionDuration` number: The session duration (in milliseconds)
  - `attachments` boolean: Weather the bot supports attachments
  - `allowFrom` string: Newline-separated list of email patterns allowed to send messages to this integration

## Response `200`

The Email integration was created successfully

- object
  - `id` string, required: The ID of the Email Integration

## Other responses

- `default`: An error response

---

[API](https://skmtc.dev/chatbotkit/apis/cbk-api.md) · [All operations](https://skmtc.dev/chatbotkit/apis/cbk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chatbotkit/apis/cbk-api/revisions/13d250576136?raw)