Galon Cloud
Galon API v1

/received-emails/{email_id}/forward

Base URL https://api.galon.ai/v1 · export GALON_API_BASE="https://api.galon.ai/v1"

POST /received-emails/{email_id}/forward

Forward a received email

Key carrying mail:send AND job:read. Served only when inbound is open to the account (404 not_found otherwise). Forwarding is an ordinary send (job mail.send).

API key (Bearer), on the public API endpoint.

Parameters

NameInTypeDescription
email_idpathstring · required
Idempotency-Keyheaderstring · required

Request body

application/json

FieldTypeDescription
toarray<string> · required
fromstring · required
notestring

Responses

StatusDescriptionBody
202Forward acceptedobject
404Not foundError
422Invalid bodyError
401Key missing or invalidError

Examples

curl

curl -X POST "$GALON_API_BASE/received-emails/<email_id>/forward" \
  -H "Authorization: Bearer $GALON_API_KEY" \
  -H "Idempotency-Key: <unique-key>" \
  -H "Content-Type: application/json" \
  -d '{"to": ["ana@example.com"], "from": "string"}'

Node.js (SDK)

import { Galon } from "galon";

const galon = new Galon(process.env.GALON_API_KEY);
const result = await galon.receivedEmails.forward("<id>", {"to": ["ana@example.com"], "from": "string"}, { idempotencyKey: "<unique-key>" });

Python (SDK)

from galon import Galon

galon = Galon()  # reads GALON_API_KEY
result = galon.received_emails.forward("<id>", {"to": ["ana@example.com"], "from": "string"}, idempotency_key="<unique-key>")