Gmail

Download one attachment, up to 10 MB, from a message in the chosen Gmail account. Returns standard base64 bytes, filename and MIME type; sends no messages and makes no public file.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gmail.attachment \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "connectionId": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "messageId": "example",
    "partId": "example"
  }'

Over MCP the same operation is the tool gmail_attachment at https://app.chirply.io/api/mcp, same bearer token, same input.

Get an account-bound browser link to connect another Gmail account. A manager must sign in and consent in Google to share reading and sending access with account members and authorized integrations. This call sends no email.

Parameters

No parameters — POST an empty body.

Example

curl -X POST https://app.chirply.io/api/v1/actions/gmail.connect \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'

Over MCP the same operation is the tool gmail_connect at https://app.chirply.io/api/mcp, same bearer token, same input.

List Gmail accounts explicitly shared with this account, their connecting user and reconnect status. Does not expose tokens, read mailbox contents or send mail.

Parameters

No parameters — POST an empty body.

Example

curl -X POST https://app.chirply.io/api/v1/actions/gmail.connections \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'

Over MCP the same operation is the tool gmail_connections at https://app.chirply.io/api/mcp, same bearer token, same input.

Read the last thirty Gmail send receipts for this account account, including failed and uncertain deliveries. Does not retry or send mail.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gmail.deliveries \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "connectionId": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool gmail_deliveries at https://app.chirply.io/api/mcp, same bearer token, same input.

Remove the saved Gmail authorization from this account and stop its sync and sending. Retains already imported Conversations and delivery receipts; does not delete anything in Google or revoke Calendar/Sheets grants.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gmail.disconnect \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "connectionId": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool gmail_disconnect at https://app.chirply.io/api/mcp, same bearer token, same input.

Import one page of historical incoming Gmail mail into Conversations. Only mail older than the initial connection is imported. Historical mail never emits incoming-mail automation triggers. Returns nextPageToken for continuing the import; sends no email itself.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gmail.import_history \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "connectionId": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool gmail_import_history at https://app.chirply.io/api/mcp, same bearer token, same input.

Read one Gmail message's sender, recipients, subject, plain text, HTML and attachment references from the chosen account account. Does not alter Gmail read status or send mail.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gmail.read_message \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "connectionId": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "messageId": "example"
  }'

Over MCP the same operation is the tool gmail_read_message at https://app.chirply.io/api/mcp, same bearer token, same input.

Read all messages in a thread from the selected Gmail account, including Sent messages and attachment references. Does not modify the mailbox or send mail.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gmail.read_thread \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "connectionId": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "threadId": "example"
  }'

Over MCP the same operation is the tool gmail_read_thread at https://app.chirply.io/api/mcp, same bearer token, same input.

Send a real reply through the selected Gmail account to the original sender or Reply-To address. Preserves Gmail thread ID, original subject and RFC reply headers. Appears in Gmail Sent; opt-outs and Google sending limits apply.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gmail.reply \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "connectionId": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "body": "example",
    "idempotencyKey": "example"
  }'

Over MCP the same operation is the tool gmail_reply at https://app.chirply.io/api/mcp, same bearer token, same input.

Search the selected shared Gmail account using Gmail query syntax. Returns message bodies, attachment references and a next-page token; does not mark messages read in Gmail or send mail.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gmail.search \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "connectionId": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool gmail_search at https://app.chirply.io/api/mcp, same bearer token, same input.

Send real email through the selected shared Gmail account, appearing in Gmail Sent. Google sending limits and account recipient opt-outs apply. Reuse idempotencyKey on retries; ambiguous deliveries are reconciled, never automatically resent.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gmail.send \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "connectionId": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "body": "example",
    "idempotencyKey": "example"
  }'

Over MCP the same operation is the tool gmail_send at https://app.chirply.io/api/mcp, same bearer token, same input.

Process one durable page of new mail for this Gmail connection. Adds incoming messages to Conversations and queues matching enabled workflows, which may send real mail or perform other configured actions. Replayed pages are deduplicated.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/gmail.sync \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "connectionId": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool gmail_sync at https://app.chirply.io/api/mcp, same bearer token, same input.