---
title: "POST /api/integrations/instantly/mailboxes"
method: POST
path: "/api/integrations/instantly/mailboxes"
tags: ["integrations"]
---

# POST /api/integrations/instantly/mailboxes

`POST /api/integrations/instantly/mailboxes`

## Request

- Base URL: `https://app.heykairon.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.heykairon.com/api/integrations/instantly/mailboxes`
- Auth: API key in header `x-api-key`

## Request body

- AddOwnedMailboxDto
  - `email` string, email, required: The full address of a mailbox the customer already owns, like `ada@acme.com`.
  - `firstName` string, required: The mailbox owner's first name — it appears in the From line of every send.
  - `lastName` string, required: The mailbox owner's last name.
  - `provider` 'google' | 'microsoft' | 'custom', required: Who hosts the mailbox. `google` for Google Workspace or Gmail, `microsoft` for Microsoft 365 or Outlook — both fill in their own server settings. `custom` for anything else, and then all four host and port fields are required.
  - `password` string, required: An APP PASSWORD for the mailbox, not the account password. For Google the operator creates one in their Google account with 2-step verification on. Ask them for it directly and never invent one; it is passed straight to the sending provider and stored nowhere in Kairon.
  - `smtpHost` string: Outgoing mail server, `custom` provider only (Google and Microsoft are known).
  - `smtpPort` integer: Outgoing mail port, `custom` provider only — usually 465 or 587.
  - `imapHost` string: Incoming mail server, `custom` provider only.
  - `imapPort` integer: Incoming mail port, `custom` provider only — usually 993.

## Response `200`

---

[API](https://skmtc.dev/heykairon/apis/kairon-api.md) · [All operations](https://skmtc.dev/heykairon/apis/kairon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/heykairon/apis/kairon-api/revisions/35de550d5938?raw)