Display a list of mailboxes for the current firm.
Normal employees can only see their own mailboxes. Owners and Senior Employees can see all mailboxes.
Headers
-
Content-Type string
-
Accept string
-
X-PLANNR-ACCOUNT-UUID string
GET /api/v1/mailboxes
curl \
-X GET https://api.plannrcrm.com/api/v1/mailboxes \
-H "Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}"
Response examples (200)
{
"data": [
{
"name": "Test Mailbox",
"type": "imap",
"uuid": "c43d8df4-2eea-49b7-a546-375ff0b11a03",
"email": "test@example.org",
"state": "connected",
"enabled": true,
"created_at": "2024-11-20T13:24:00+00:00",
"created_by": {
"firm": {
"example": "App\\Http\\Resources\\FirmResource",
"collection": false,
"description": "Firm"
},
"name": {
"example": "Gareth Thompson",
"collection": false,
"description": "Name"
},
"role": {
"example": "client",
"collection": false,
"description": "Account role"
},
"tags": {
"example": "App\\Http\\Resources\\TagResource",
"collection": true,
"description": "Tags"
},
"type": {
"example": "client",
"collection": false,
"description": "Account type"
},
"uuid": {
"example": "8a6192dc-1377-416b-8a52-60bd1d80dac6",
"collection": false,
"description": "The UUID of the resource."
},
"email": {
"example": "gareth@codepotato.co.uk",
"collection": false,
"description": "Email"
},
"groups": {
"example": "App\\Http\\Resources\\GroupResource",
"collection": true,
"description": "Groups"
},
"owners": {
"example": "App\\Http\\Resources\\AccountResource",
"collection": true,
"description": "Accounts that own this account"
},
"last_name": {
"example": "Thompson",
"collection": false,
"description": "Last name"
},
"created_at": {
"example": "2024-11-20T13:24:00+00:00",
"collection": false,
"description": "The timestamp of when the resource was created."
},
"first_name": {
"example": "Gareth",
"collection": false,
"description": "First name"
},
"updated_at": {
"example": "2024-11-20T13:24:00+00:00",
"collection": false,
"description": "The timestamp of when the resource was updated."
},
"with_login": {
"example": true,
"collection": false,
"description": "Denotes whether the account has a login to Plannr"
},
"custom_fields": {
"example": "App\\Http\\Resources\\CustomFieldValueResource",
"collection": true,
"description": "Any custom fields on the model."
},
"introduced_by": {
"example": "App\\Http\\Resources\\AccountResource",
"collection": false,
"description": "Introduced by"
},
"primary_email": {
"example": "App\\Http\\Resources\\ContactDetailResource",
"collection": false,
"description": "Primary email"
},
"can_be_deleted": {
"example": "false",
"collection": false,
"description": "Denotes if the account can be deleted"
},
"assigned_adviser": {
"example": "App\\Http\\Resources\\AccountResource",
"collection": false,
"description": "Assigned adviser"
},
"next_review_date": {
"example": "2024-11-20T13:24:00+00:00",
"collection": false,
"description": "Next review date"
},
"has_joint_account": {
"example": true,
"collection": false,
"description": "Denotes whether this account belongs to a joint account too"
},
"current_time_entry": {
"example": "App\\Http\\Resources\\TimeEntryResource",
"collection": false,
"description": "Current time entry"
},
"first_contact_date": {
"example": "2024-11-20T13:24:00+00:00",
"collection": false,
"description": "First contact date"
},
"external_references": {
"example": "App\\Http\\Resources\\ExternalReferenceResource",
"collection": true,
"description": "The external references that have been added to the client."
},
"assigned_paraplanner": {
"example": "App\\Http\\Resources\\AccountResource",
"collection": false,
"description": "Assigned paraplanner"
},
"previous_review_date": {
"example": "2024-11-20T13:24:00+00:00",
"collection": false,
"description": "Previous review date"
},
"primary_phone_number": {
"example": "App\\Http\\Resources\\ContactDetailResource",
"collection": false,
"description": "Primary phone number"
},
"assigned_administrator": {
"example": "App\\Http\\Resources\\AccountResource",
"collection": false,
"description": "Assigned administrator"
},
"anniversary_review_date": {
"example": "2024-11-20T13:24:00+00:00",
"collection": false,
"description": "Anniversary review date"
}
},
"updated_at": "2024-11-20T13:24:00+00:00",
"message_count": 1
}
]
}