Write Post API

Connections

List active social media connections for Write Post.

GET /api/v1/write-post/connections/ Live

List active social connections for the authenticated account’s active workspace. Connecting or disconnecting accounts is done in the dashboard — not via this API.

Authentication: Bearer API key required
Permission: write_post
Rate limit: Per-key default 60 req/min

Notes

Only active/usable connections are returned.
OAuth secrets and credentials are never included.
Manage connections at Dashboard → Connections.

Headers

HTTP

Authorization: Bearer YOUR_API_KEY
Accept: application/json

Examples

cURL

curl -X GET "https://YOUR-DOMAIN/api/v1/write-post/connections/" -H "Authorization: Bearer YOUR_API_KEY"

JavaScript

const response = await fetch("https://engagegrove.com/api/v1/write-post/connections/", {
  method: "GET",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    Accept: "application/json"
  }
});
const data = await response.json();

Python

import requests

url = "https://engagegrove.com/api/v1/write-post/connections/"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}
response = requests.request("GET", url, headers=headers)
print(response.json())

PHP

$ch = curl_init("https://engagegrove.com/api/v1/write-post/connections/");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOUR_API_KEY",
    "Accept: application/json"
  ]
]);
$response = curl_exec($ch);
curl_close($ch);

Response example

JSON

{
  "success": true,
  "request_id": "req_...",
  "data": {
    "count": 1,
    "connections": [
      {
        "id": 1,
        "platform": "twitter",
        "platform_label": "X",
        "account_name": "demo",
        "account_username": "demo",
        "status": "active",
        "status_label": "Active",
        "credential_type": "oauth",
        "workspace_id": "ws_...",
        "connected_at": "2026-01-01 12:00:00",
        "last_verified_at": "—",
        "last_publish_at": "—",
        "last_error": "",
        "is_usable": true
      }
    ]
  }
}

Status codes

Status	Meaning
`200`	Success
`401`	Invalid API key
`403`	Missing write_post permission
`429`	Rate limit exceeded

Try it

Paste your API key locally. It is sent only to this site’s API and is never saved.

API Key

Create API Key →

Errors

INVALID_API_KEY — missing/invalid Bearer token
SERVICE_ACCESS_DENIED — key lacks write_post
VALIDATION_ERROR — invalid payload or domain validation
RESOURCE_NOT_FOUND — unknown resource
RATE_LIMIT_EXCEEDED — too many requests

Full error reference →