Inbound

Update a forwarding rule

Updates the destination and/or active flag of a forwarding rule. The localpart cannot be changed — to rename a localpart, DELETE the rule and POST a new one. The same (localpart, destination) pair can be re-created immediately after deletion.

Changing destination re-runs the destination verification flow: if the new address has not been verified for this owner, the rule is reset to verified: 0 and a confirmation email is sent. The rule will not deliver mail until the new destination is confirmed. Toggling active alone does not affect the verified flag.

PATCH

inbound

domains

{uuid}

forward-rules

{ruleUuid}

curl --request PATCH \
  --url https://api.jetemail.com/inbound/domains/{uuid}/forward-rules/{ruleUuid} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "destination": "[email protected]"
}
'

{
  "success": true,
  "result": {
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "localpart": "<string>",
    "destination": "[email protected]",
    "active": 0,
    "verified": 0,
    "last_modified": 123,
    "created_at": 123
  }
}

Authorizations

Authorization

string

header

required

API key for account management endpoints. Use your api_ prefixed token.

Path Parameters

uuid

string<uuid>

required

UUID of the domain

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$

ruleUuid

string<uuid>

required

UUID of the forwarding rule

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$

Body

application/json

destination

string<email>

New destination email. Validated as a bare local@domain.

active

boolean

Toggle the rule on/off without deleting it.

Response

Rule updated

success

boolean

Example:

true

result

object

Show child attributes

List verified (and pending) forwarding destinationsReturns every destination address registered for the caller's account or organization, with its verification status. A destination is shared across every forwarding rule the same owner creates — verifying once lights up every rule that points at it. Pending rows include the ones whose verification email is unread; use POST /inbound/forward-destinations/{uuid}/resend to send a fresh email.

curl --request PATCH \
  --url https://api.jetemail.com/inbound/domains/{uuid}/forward-rules/{ruleUuid} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "destination": "[email protected]"
}
'

{
  "success": true,
  "result": {
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "localpart": "<string>",
    "destination": "[email protected]",
    "active": 0,
    "verified": 0,
    "last_modified": 123,
    "created_at": 123
  }
}

Overview

Endpoints

Update a forwarding rule

Authorizations

Path Parameters

Body

Response