API REFERENCE

Email API

The email resource is a thin read surface. AlgaPSA sends and receives mail through its own configured providers and workflows; over the REST API there is one endpoint, GET /email, for reading the tenant's email state.

What you can call

GET /email is the only operation here. Treat it as a status read rather than a way to send messages — there is no create or send endpoint on this resource. If you need to drive inbound mail into AlgaPSA, model it as an inbound webhook instead.

Endpoints

Every endpoint links through to its full parameters, request and response schemas, and code samples.

POST/api/email/oauth/initiateAlgaPSAAlgaDeskInitiate email OAuth flowPOST/api/email/refresh-watchAlgaPSARefresh Gmail watch registrationPOST/api/email/webhooks/googleAlgaPSAReceive Google Gmail Pub/Sub webhookOPTIONS/api/email/webhooks/googleAlgaPSACORS preflight for Google email webhookGET/api/email/webhooks/microsoftAlgaPSAValidate Microsoft email webhook subscriptionPOST/api/email/webhooks/microsoftAlgaPSAReceive Microsoft Graph email webhookOPTIONS/api/email/webhooks/microsoftAlgaPSACORS preflight for Microsoft email webhookPOST/api/email/webhooks/testAlgaPSAPublish test inbound email eventGET/api/v1/emailAlgaPSAAlgaDeskEmail API namespace root