Integrations
Buffer datasets and fields
The 3 datasets Maven lands from Buffer, every field in them, and how the connection syncs.
Maven lands 3 datasets from Buffer in each client workspace. This page lists every one with all of its fields. For the metrics, reports and setup steps, see the Buffer integration page.
Connection and sync#
You connect Buffer with API credentials from the Buffer account. Maven stores them encrypted.
The first Buffer sync pulls the most recent 30 days so the workspace fills quickly. A follow-up backfill then adds older history, up to 12 months in total. After that, each scheduled sync re-reads the last 30 days, so late changes are picked up.
Datasets#
Channels#
Buffer channel identity and connection snapshots.
| Field | Type |
|---|---|
| date | Date |
| organization ID | Text |
| organization name | Text |
| channel ID | Text |
| channel name | Text |
| channel display name | Text |
| channel descriptor | Text |
| service | Text |
| service ID | Text |
| channel type | Text |
| external link | Text |
| avatar | Text |
| timezone | Text |
| scopes json | Text |
| is disconnected | True/false |
| is locked | True/false |
| is queue paused | True/false |
| created at | Timestamp |
| updated at | Timestamp |
| integration ID | Text |
Posts#
Buffer sent post metadata and the complete metrics JSON bag.
| Field | Type |
|---|---|
| date | Date |
| snapshot date | Date |
| metric date | Date |
| metric as of date | Date |
| organization ID | Text |
| organization name | Text |
| channel ID | Text |
| channel name | Text |
| channel display name | Text |
| channel service | Text |
| channel service ID | Text |
| post ID | Text |
| text | Text |
| status | Text |
| content type | Text |
| via | Text |
| scheduling type | Text |
| share mode | Text |
| shared now | True/false |
| is custom scheduled | True/false |
| created at | Timestamp |
| updated at | Timestamp |
| due at | Timestamp |
| sent at | Timestamp |
| external link | Text |
| assets json | Text |
| tags json | Text |
| metrics updated at | Timestamp |
| metrics json | Text |
| integration ID | Text |
Post metric snapshots#
Lossless long-form Buffer post metric snapshots.
| Field | Type |
|---|---|
| date | Date |
| snapshot date | Date |
| metric date | Date |
| metric as of date | Date |
| organization ID | Text |
| organization name | Text |
| channel ID | Text |
| channel service | Text |
| channel service ID | Text |
| post ID | Text |
| metric type | Text |
| metric name | Text |
| metric description | Text |
| metric value | Number |
| metric unit | Text |
| metrics updated at | Timestamp |
| raw metric json | Text |
| integration ID | Text |