Synup Posts API

The Posts API from Synup — 6 operation(s) for posts.

Operations 7

POST /bulk-posts Create a bulk post
POST /posts Create an Announcement post
DELETE /posts/{postId} Delete a post
GET /posts/{postId} Get a single post
GET /bulk-posts/{bulkPostId} Fetch a bulk post by ID
GET /locations/{locationId}/bulk-posts Fetch bulk posts for a location
GET /locations/{locationId}/posts Fetch posts for a location

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/synup-posts-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

synup-posts-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Synup Posts API
  version: '4'
  description: 'REST API v4 for the Synup local marketing platform: business locations, listing syndication to 80+ directories, review/interaction aggregation and response, review campaigns, local rank tracking and grid-rank heatmaps, local and social posts, AI post ideas, menus, connected accounts, users and profile analytics.


    ASSEMBLED BY API EVANGELIST from the per-endpoint OpenAPI documents Synup publishes on its own documentation host (developer.synup.com, Apidog project 797384). Every operation, parameter, response, example and schema below is verbatim provider content; only the merge into a single document is ours. Source index: https://developer.synup.com/llms.txt'
  contact:
    name: Synup Developer Documentation
    url: https://developer.synup.com/
  x-assembled-by: api-evangelist enrichment pipeline (local-v1)
  x-assembled-from: 506 per-endpoint OpenAPI fragments published at https://developer.synup.com/<slug>.md
  x-assembled-date: '2026-08-13'
servers:
- url: https://api.synup.com/api/v4
  description: Base ENV (as published in every Synup doc fragment). Tenant workspace domains (https://<workspace>.synup.com/api/v4) also serve the same API.
tags:
- name: Posts
paths:
  /bulk-posts:
    post:
      summary: Create a bulk post
      deprecated: false
      description: ''
      tags:
      - Posts
      parameters:
      - name: Content-Type
        in: header
        description: ''
        required: true
        example: application/json
        schema:
          type: string
      - name: Authorization
        in: header
        description: ''
        required: true
        example: API VGLYvxxxxxxxxxxxxxxxxxxxxx
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                input:
                  type: object
                  properties:
                    postName:
                      type: string
                    locationIds:
                      type: array
                      items:
                        type: string
                    postType:
                      type: string
                    postSites:
                      type: array
                      items:
                        type: string
                    postMessage:
                      type: array
                      items:
                        type: object
                        properties:
                          site:
                            type: string
                          message:
                            type: string
                  required:
                  - postName
                  - locationIds
                  - postType
                  - postSites
                  - postMessage
              required:
              - input
            example:
              input:
                postName: Bulk Announcement
                locationIds:
                - '{locationId1}'
                - '{locationId2}'
                postType: ANNOUNCEMENT
                postSites:
                - GOOGLE
                postMessage:
                - site: GOOGLE
                  message: Message for all locations
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
          headers: {}
          x-apidog-name: Success
      security: []
      x-apidog-folder: Posts
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-33169612-run
  /posts:
    post:
      summary: Create an Announcement post
      deprecated: false
      description: ''
      tags:
      - Posts
      parameters:
      - name: Content-Type
        in: header
        description: ''
        required: true
        example: application/json
        schema:
          type: string
      - name: Authorization
        in: header
        description: ''
        required: true
        example: API Tsdfccsdfxxxxx
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                input:
                  type: object
                  properties:
                    postName:
                      type: string
                    locationIds:
                      type: array
                      items:
                        type: string
                    postType:
                      type: string
                    postSites:
                      type: array
                      items:
                        type: string
                    postMessage:
                      type: array
                      items:
                        type: object
                        properties:
                          site:
                            type: string
                          message:
                            type: string
                  required:
                  - postName
                  - locationIds
                  - postType
                  - postSites
                  - postMessage
              required:
              - input
            example:
              input:
                postName: Grand Opening Announcement
                locationIds:
                - '{locationId}'
                postType: ANNOUNCEMENT
                postSites:
                - GOOGLE
                postMessage:
                - site: GOOGLE
                  message: We are now open!
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
          headers: {}
          x-apidog-name: Success
      security: []
      x-apidog-folder: Posts
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-33169275-run
  /posts/{postId}:
    delete:
      summary: Delete a post
      deprecated: false
      description: ''
      tags:
      - Posts
      parameters:
      - name: postId
        in: path
        description: ''
        required: true
        example: ''
        schema:
          type: string
      - name: Authorization
        in: header
        description: ''
        required: true
        example: API VGLYvxxxxxxxxxxxxxxxxxxxxx
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
          headers: {}
          x-apidog-name: Success
      security: []
      x-apidog-folder: Posts
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-33169611-run
    get:
      summary: Get a single post
      deprecated: false
      description: ''
      tags:
      - Posts
      parameters:
      - name: postId
        in: path
        description: ''
        required: true
        example: ''
        schema:
          type: string
      - name: Authorization
        in: header
        description: ''
        required: true
        example: API VGLYvxxxxxxxxxxxxxxxxxxxxx
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
          headers: {}
          x-apidog-name: Success
      security: []
      x-apidog-folder: Posts
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-33169610-run
  /bulk-posts/{bulkPostId}:
    get:
      summary: Fetch a bulk post by ID
      deprecated: false
      description: ''
      tags:
      - Posts
      parameters:
      - name: bulkPostId
        in: path
        description: ''
        required: true
        example: ''
        schema:
          type: string
      - name: Authorization
        in: header
        description: ''
        required: true
        example: API VGLYvxxxxxxxxxxxxxxxxxxxxx
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
          headers: {}
          x-apidog-name: Success
      security: []
      x-apidog-folder: Posts
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-33169732-run
  /locations/{locationId}/bulk-posts:
    get:
      summary: Fetch bulk posts for a location
      deprecated: false
      description: ''
      tags:
      - Posts
      parameters:
      - name: locationId
        in: path
        description: ''
        required: true
        example: ''
        schema:
          type: string
      - name: page
        in: query
        description: ''
        required: true
        example: '1'
        schema:
          type: string
      - name: perPage
        in: query
        description: ''
        required: true
        example: '10'
        schema:
          type: string
      - name: tag
        in: query
        description: ''
        required: false
        example: ''
        schema:
          type: string
      - name: Authorization
        in: header
        description: ''
        required: true
        example: API VGLYvxxxxxxxxxxxxxxxxxxxxx
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
          headers: {}
          x-apidog-name: Success
      security: []
      x-apidog-folder: Posts
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-33169760-run
  /locations/{locationId}/posts:
    get:
      summary: Fetch posts for a location
      deprecated: false
      description: ''
      tags:
      - Posts
      parameters:
      - name: locationId
        in: path
        description: ''
        required: true
        example: ''
        schema:
          type: string
      - name: page
        in: query
        description: ''
        required: true
        example: '1'
        schema:
          type: string
      - name: perPage
        in: query
        description: ''
        required: true
        example: '10'
        schema:
          type: string
      - name: tag
        in: query
        description: ''
        required: false
        example: ''
        schema:
          type: string
      - name: Authorization
        in: header
        description: ''
        required: true
        example: API VGLYvxxxxxxxxxxxxxxxxxxxxx
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
          headers: {}
          x-apidog-name: Success
      security: []
      x-apidog-folder: Posts
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-33169608-run