ShopEazydevelopers
API referenceMerchant API BetaSocial

One post

Beta
Credentials
  • OAuth access token
Scopes
marketing:write
GET
/v1/merchant/stores/{storeId}/social/posts/{postId}

Access: OAuth scope marketing:write; not write-gated.

Authorization

merchantOAuth marketing:write
headerAuthorizationBearer <token>

OAuth 2.1 (authorization code + PKCE S256, public clients, dynamic registration) for connected AI apps. Effective power is scopes granted AND the person's role today AND the plan. orders:refund, billing:write and team:write are opt-in on the consent screen. Write implies read for marketing:read and messages:read, so a grant holding marketing:write passes a marketing:read check, and messages:send passes messages:read.

Scope: marketing:write

Path Parameters

storeId*string

A store the person can reach. Any other id answers 404, never 403.

postId*string

Response Body

OK

application/json
  1. response
data*
Example Request
curl -X GET 'https://api.shopeazy.co/v1/merchant/stores/<storeId>/social/posts/<postId>' \  -H 'Authorization: Bearer <access_token>'
Example Response
{  "data": {    "id": "string",    "status": "draft",    "channels": [      "facebook"    ],    "message": {      "facebook": "string",      "instagram": "string"    },    "imageUrls": [      "string"    ],    "videoUrl": "string",    "linkUrl": "string",    "scheduledAt": 0,    "publishedAt": 0,    "results": {      "property1": {        "status": "pending",        "error": "string",        "permalink": "string"      },      "property2": {        "status": "pending",        "error": "string",        "permalink": "string"      }    },    "createdAt": 0  }}

Draft a post about up to 10 listings POST

Saved as a draft: nothing is posted. Photos come from the listings. The Facebook caption gets the product link (`{link}` marks where, or it is added at the end). Instagram needs a photo. Needs a connected Facebook Page. Owner or admin. Access: OAuth scope `marketing:write`; write-gated by the subscription.

Edit a draft, scheduled or failed post PATCH

Changes the captions, photos or channels of a post that has not gone out (`draft`, `scheduled`, `failed` or `partial`). A post that has already gone out is 422 `validation_error` ("That post has already gone out."). The status does not change: a draft stays a draft, a `scheduled` post keeps its time (use `scheduleSocialPost` to change it) and a `partial` post stays `partial`, so its published channels are not posted again by `publishSocialPost`. New photos must be the shop's own (already on the post, on a listing, or stored by the business): any other link is 422 `validation_error`. Needs a connected Facebook Page. Access: OAuth scope `marketing:write`; write-gated by the subscription.