v51

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-01121113461.4 KB
channels

Manage personal (scope_level=user) integration channels

post/api/v1.0/users/me/channels/

Request body

OR

Response

Existing push device refreshed (idempotent re-register).

idstring uuid required

primary key for the record as UUID

namestring required

Human-readable name for this channel

typestring required

Type of channel

scope_level'global' | 'maildomain' | 'mailbox' | 'user' required
  • global - Global
  • maildomain - Maildomain
  • mailbox - Mailbox
  • user - User
is_activeboolean

Uncheck to pause this channel without deleting it.

{"stackTrail":"components:schemas:Channel:properties:settings","oasType":"schema","type":"unknown","description":"Channel-specific configuration settings"}
mailboxstring uuid nullable required

primary key for the record as UUID

maildomainstring uuid nullable required

primary key for the record as UUID

userstring uuid nullable required

primary key for the record as UUID

last_used_atstring date-time nullable required
token_hashstring nullable required
created_atstring date-time required

date and time at which a record was created

updated_atstring date-time required

date and time at which a record was last updated