post
https://production-api.shoutaboutus.com/api/v1/facebook/review-site/connect
Connect a Facebook page to a store review site. Guards against a page already linked elsewhere. Saves the page token + id, sets sendto_scrapper=Y, url_status=enable, connection_status=connected. Stores the FB user token on the company if not already set; and deletes prior response rows if the page changed. Emits audit STORE_REVIEW_SITE_OAUTH_CONNECTED.
Auth
- Auth-optional. Bearer token (scoped by an ownership check) OR an invite
hash(no token) whose encoded store must ownstore_review_site_id.
Rate limit
- 30 requests/min per IP (public).
Body
| Field | Type | Required | Notes |
|---|---|---|---|
store_review_site_id | integer | Required | Must exist; caller scope (an ownership check) unless using hash. |
fb_token | string (≤2000) | Required | Long-lived user access token. |
fbpage_access_token | string (≤2000) | Required | Page access token. |
fbpage_id | string (≤255) | Required | Facebook page id. |
url | url (5–2000) | Required | Facebook page URL → review_site_url + landing_page_url. |
scopes | array | Optional | Granted OAuth scopes. |
fbpage_name | string (≤255) | Optional | Facebook page display name, recorded with the connection event. |
landing_page_url | url (5–2000) | Optional | Accepted; the page url is used for the landing page. |
hash | string | Optional | Invite hash [store_id, 15]; grants access without a token, must match the row's store. |
Behaviour
- 200 on connect. 400 if the page is already linked to another place.
Errors: 422 on validation failure.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…