Adopt social content

social.outputs.adopt@1

Saves a draft post for each account you choose, from a caption you give or the result of an automation. Drafts are never approved, dated or published by this call. It needs a key with Write social.

Save a draft for an account

Replace YOUR_ACCOUNT_ID with an account's id.

# A new operationId for each new request; the same one to retry it.
curl https://api.growlocal.site/api/v1/profiles/YOUR_BUSINESS_ID/invocations \
  -H "Authorization: Bearer gl_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "target": {
    "featureId": "YOUR_FEATURE_ID",
    "export": "adoptOutputs",
    "contractRef": "social.outputs.adopt@1"
  },
  "operationId": "adopt-post-1",
  "input": {
    "accountRefs": [
      {
        "businessProfileId": "YOUR_BUSINESS_ID",
        "featureId": "juniper-cakes.social",
        "collectionId": "juniper-cakes.accounts",
        "id": "YOUR_ACCOUNT_ID"
      }
    ],
    "caption": "This week: lemon drizzle, fresh from the oven.",
    "mediaRefs": [],
    "format": "post"
  }
}'

// A new operationId for each new request; the same one to retry it.
const response = await fetch(
  "https://api.growlocal.site/api/v1/profiles/YOUR_BUSINESS_ID/invocations",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer gl_YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      "target": {
        "featureId": "YOUR_FEATURE_ID",
        "export": "adoptOutputs",
        "contractRef": "social.outputs.adopt@1"
      },
      "operationId": "adopt-post-1",
      "input": {
        "accountRefs": [
          {
            "businessProfileId": "YOUR_BUSINESS_ID",
            "featureId": "juniper-cakes.social",
            "collectionId": "juniper-cakes.accounts",
            "id": "YOUR_ACCOUNT_ID"
          }
        ],
        "caption": "This week: lemon drizzle, fresh from the oven.",
        "mediaRefs": [],
        "format": "post"
      }
    }),
  },
);
const receipt = await response.json();
console.log(response.status, receipt);

import requests

# A new operationId for each new request; the same one to retry it.
response = requests.post(
    "https://api.growlocal.site/api/v1/profiles/YOUR_BUSINESS_ID/invocations",
    headers={"Authorization": "Bearer gl_YOUR_API_KEY"},
    json={
        "target": {
            "featureId": "YOUR_FEATURE_ID",
            "export": "adoptOutputs",
            "contractRef": "social.outputs.adopt@1",
        },
        "operationId": "adopt-post-1",
        "input": {
            "accountRefs": [
                {
                    "businessProfileId": "YOUR_BUSINESS_ID",
                    "featureId": "juniper-cakes.social",
                    "collectionId": "juniper-cakes.accounts",
                    "id": "YOUR_ACCOUNT_ID",
                },
            ],
            "caption": "This week: lemon drizzle, fresh from the oven.",
            "mediaRefs": [],
            "format": "post",
        },
    },
    timeout=30,
)
print(response.status_code, response.json())

Parameters

What goes in input:

Response

A call that worked answers 200 with an applied receipt; its output holds these fields, among others. GET /catalog/social.outputs.adopt@1 answers the complete shape as JSON Schema.

{
  "status": "applied",
  "operationId": "adopt-post-1",
  "output": {
    "editions": [
      {
        "ref": {
          "businessProfileId": "YOUR_BUSINESS_ID",
          "featureId": "juniper-cakes.social",
          "collectionId": "juniper-cakes.editions",
          "id": "YOUR_EDITION_ID"
        },
        "revision": 1,
        "account": {
          "ref": {
            "businessProfileId": "YOUR_BUSINESS_ID",
            "featureId": "juniper-cakes.social",
            "collectionId": "juniper-cakes.accounts",
            "id": "YOUR_ACCOUNT_ID"
          },
          "revision": 1,
          "label": "Juniper Cakes",
          "platform": "x",
          "handle": "junipercakes",
          "connected": true,
          "textPost": {
            "compatible": true
          },
          "constraints": null
        },
        "caption": "This week: lemon drizzle, fresh from the oven.",
        "mediaRefs": [],
        "format": "post",
        "platformOptions": {},
        "notes": "",
        "source": null,
        "createdAt": "2026-11-13T09:30:00Z",
        "createdBy": null,
        "contentDigest": "0000000000000000000000000000000000000000000000000000000000000000",
        "approval": {
          "state": "none",
          "digest": null,
          "approvedAt": null,
          "approvedBy": null,
          "review": null
        },
        "publication": null,
        "status": "draft",
        "canEdit": true,
        "canApprove": true,
        "canSchedule": false,
        "canCancel": false,
        "canRemove": true
      }
    ]
  }
}

Errors

Besides the answers every request can get (Errors), its receipt can say:

The codes in diagnostics you're most likely to see: