List meetings, or create one with POST. derived from route
URL
- User APIhttps://sales.mattering.io/api/user/v1/meetings/
- Service tierhttps://sales.mattering.io/api/internal/meetings/
Query parameters
| Name | Default |
|---|---|
sort | none |
start_after | none |
start_before | none |
Body keys (JSON)
| Key | Required | Default |
|---|---|---|
business_id | optional or conditional | none |
contact_id | optional or conditional | none |
description | optional or conditional | none |
end_at | optional or conditional | none |
is_all_day | optional or conditional | none |
location | optional or conditional | none |
meeting_url | optional or conditional | none |
start_at | optional or conditional | none |
status | optional or conditional | none |
title | optional or conditional | none |
Keys the view reads. A key not in this list is ignored by the view, silently. Where a key is required only for some actions (for example the action dispatch), the description above says which.
Pagination
Accepts limit and offset. The response meta carries total, returned, has_more and next_offset.
Responses
200 data and meta envelope
{
"data": {
"meetings": [
{
"...": "..."
}
]
},
"meta": {
"total": 0,
"limit": 0,
"offset": 0,
"returned": 0,
"has_more": true,
"next_offset": 0
}
}
201 data and meta envelope
{
"data": {
"meeting": {
"...": "..."
}
},
"meta": {
"total": 0,
"limit": 0,
"offset": 0,
"returned": 0,
"has_more": true,
"next_offset": 0
}
}
Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).
Errors
| Status | Code |
|---|---|
| 400 | anchor_mismatch |
| 400 | invalid_json |
| 400 | invalid_times |
| 400 | missing_field |
| 403 | unknown_actor |
| 404 | business_not_found |
| 404 | contact_not_found |
| 409 | calendar_unavailable |
| 502 | calendar_error |
Example
curl -X POST "https://sales.mattering.io/api/user/v1/meetings/" \
-H "Authorization: Bearer $MATTERING_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"business_id": "...",
"contact_id": "...",
"description": "...",
"end_at": "...",
"is_all_day": "...",
"location": "...",
"meeting_url": "...",
"start_at": "..."
}'curl -X POST "https://sales.mattering.io/api/internal/meetings/" \
-H "X-Internal-Secret: $MATTERING_INTERNAL_API_SECRET" \
-H "X-Internal-Org-Id: $ORG_ID" \
-H "X-Internal-User-Email: you@example.com" \
-H "Content-Type: application/json" \
-d '{
"business_id": "...",
"contact_id": "...",
"description": "...",
"end_at": "...",
"is_all_day": "...",
"location": "...",
"meeting_url": "...",
"start_at": "..."
}'
Source: CRMCore/timeline_api.py (timeline_api.meetings)