List emails
Deleted ones only when the status filter asks for them.
Deleted ones only when the status filter asks for them.
apiKey readAuthorizationBearer <token>A workspace API key (pf_…), created under Developers → API keys.
Scope: read
page?integerStarts at 1
1 <= value1pageSize?numberOne of 10, 25, 50, 100
25q?stringSearch
1 <= length <= 200status?stringComma-separated, any of: active, archived
sort?stringOne of name, createdAt, updatedAt; prefix with - for descending
"-updatedAt""name""-name""createdAt""-createdAt""updatedAt""-updatedAt"OK
application/json- response
items*array<>total*integerpage*integerpageSize*integercurl -X GET 'https://api.postforge.dev/v1/emails'{ "items": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "kind": "string", "name": "string", "folder": { "id": "string", "name": "string" }, "status": "active", "versionId": "14707576-2549-4848-82ed-f68f8a1b47c7", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "archivedAt": "2019-08-24T14:15:22Z", "locales": [ "string" ], "thumbnailUrl": "http://example.com" } ], "total": 0, "page": 0, "pageSize": 0}Make a campaign’s email from a template POST
Copies the template’s latest document (or a starter’s, in the workspace’s default locale) into a new email of the campaign’s own (D104, D174), named after it, with no subject yet and everyone else getting the workspace’s default locale when the email has it, and saves the campaign with it. 409 `email_exists` when the campaign has one already: edit that one instead.
Create a email POST
Its first version is in use right away.