API Reference/Endpoints

Update an email

PUT/api/linkedin/gateway/emails/{email_id}

Flips an email's read state, moves it between folders, or (Outlook only) changes its categories. Fields left out are left untouched.

Authentication

Send your personal API key as a bearer token. A missing, malformed or revoked key returns 401.

Path parameters

FieldTypeDescription

email_id *stringThe email's id.

Body parameters

FieldTypeDescription

account_id *stringThe connected account the email belongs to.

unreadbooleanMarks just this email as read or unread.

foldersstring[]Moves the email into these folders. Outlook and IMAP mailboxes only accept a single folder per call.

categoriesstring[]Outlook only — replaces the email's categories.

Only fields present in the body are changed — send just unread to mark a message read without touching its folder.

Response fields

FieldTypeDescription

object"EmailUpdated"Always this value.

Errors

·401 Unauthorized. The key is missing, malformed or has been rotated.·403 Forbidden. The account_id doesn't belong to this key.·404 Not Found. No email with that id belongs to this account.