Skip to main content
PATCH
Update a mail filter or automation

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Filing or automation id

Body

application/json

Omitted fields are left alone. The match, attachments, then and backfill belong to the mailbox owner. folder, paused and use_my_mailbox are also an admin's on anyone's filing.

name
string
run_on_import
boolean
addresses
string[]
domains
string[]
subjects
string[]
attachments
boolean
then
object

An automation's action, run once per message it files.

folder
string
paused
boolean
backfill
boolean

True restarts the history import over the full window. Messages already filed are not filed twice.

use_my_mailbox
boolean

Move a stopped or someone else's filing onto the caller's own mailbox

Response

Success

A mail filter or an automation. Matching messages from the owner's mailbox are saved into folder as .eml files, and an automation then runs its action on each.

id
string
kind
enum<string>

A record with no kind is a filter

Available options:
filter,
automation
name
string

Automations only

space_id
string
folder
string

Space-relative dot path the files land in

entity_type
string
entity_folder
string

Contact or organisation folder the filter was set up from

addresses
string[]
domains
string[]
subjects
string[]

Subject words to match

attachments
boolean

Also save attachments beside the copy

then
object

An automation's action, run once per message it files.

run_on_import
boolean

Whether the action also runs for imported history. Off by default.

mailbox_user_id
string
mailbox_display_name
string
created_by
string
state
enum<string>
Available options:
active,
paused,
removed
stopped
object

Why a filter paused by itself

backfill
object

History import progress

last_filed_at
string<date-time>
filed_count
integer
created_at
string<date-time>
updated_at
string<date-time>