Skip to Content
SendlySendly
API ReferenceProjects

List the projects the authenticated user belongs to

GET
/api/users/me/projects

Every project the caller is a member of, in any role. Answers a bare JSON array — no { success, data } envelope — of raw project rows, each carrying the derived sandboxAddress alongside its columns.

This is the project picker for a connected app. It is user-scoped rather than project-scoped, so it is the one operation that takes no x-project-id header; the id of the project the user chooses here is what every subsequent call sends in that header.

The body depends on the credential. A delegated (OAuth) token receives ProjectPickerEntry — the project, and nothing about the account behind it. A browser session receives ProjectListEntry, the raw row including the account's Stripe identifiers and billing ceilings, because that is the account holder reading their own account. Build against ProjectPickerEntry.

Requires the projects:read scope — View your projects and their settings.

cookiebetter-auth.session_token<token>

BetterAuth session cookie. Used by the dashboard / browser clients. When present, the active project is taken from the x-project-id header.

Response Body

The caller's projects — ProjectPickerEntry for a delegated token, the full row for a session

application/json
  1. response
[index: integer]?

A project the authorizing user belongs to, as a connected app sees it. Use id as the x-project-id header on every subsequent call.

Example Request
curl -X GET 'https://api.sendly.now/api/users/me/projects'
Example Response
[  {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "name": "string",    "disabled": true,    "sandboxAddress": "string",    "sesRegion": "string",    "tracking": "ENABLED",    "language": "string",    "createdAt": "2019-08-24T14:15:22Z"  }]