Autoposting.ai

Autoposting.ai Webhooks API

Configure outbound webhook endpoints to receive real-time event notifications from Autoposting.ai.

GitHub OpenAPI

Operations 6

POST /webhooks Create a webhook endpoint #
GET /webhooks List webhook endpoints #
PATCH /webhooks/{webhookId} Update a webhook #
DELETE /webhooks/{webhookId} Delete a webhook #
POST /webhooks/{webhookId}/test Send a test delivery #
GET /webhooks/{webhookId}/deliveries List delivery history #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/autoposting-ai/openapi/autoposting-ai-webhooks-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/autoposting-ai/json-schema/autoposting-ai-post-schema.json
📊
JSONSchema
https://artifacts.apis.io/autoposting-ai/json-schema/autoposting-ai-api-key-schema.json
📊
JSONSchema
https://artifacts.apis.io/autoposting-ai/json-schema/autoposting-ai-agent-schema.json
📊
JSONSchema
https://artifacts.apis.io/autoposting-ai/json-schema/autoposting-ai-usage-summary-schema.json
📊
JSONSchema
https://artifacts.apis.io/autoposting-ai/json-schema/autoposting-ai-brand-schema.json
📊
JSONSchema
https://artifacts.apis.io/autoposting-ai/json-schema/autoposting-ai-clip-schema.json

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/autoposting-ai:autoposting-ai-webhooks-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.

GitHub Google LinkedIn

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

OpenAPI Specification

autoposting-ai-webhooks-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Autoposting Webhooks API
  description: 'Schedule, publish, and AI-enhance social content across X, LinkedIn, Instagram, Threads, and YouTube. All responses use the `{ "success": boolean, "data": ... }` envelope. Authenticate with an API key (`Authorization: Bearer sk-social-...` or `x-api-key: sk-social-...`).'
  version: 1.0.0
servers:
- url: https://app.autoposting.ai/api-proxy
  description: Production
security:
- bearerAuth: []
- apiKeyHeader: []
tags:
- name: Webhooks
  description: Configure outbound webhook endpoints to receive real-time event notifications from Autoposting.ai.
paths:
  /webhooks:
    post:
      tags:
      - Webhooks
      operationId: createWebhook
      summary: Create a webhook endpoint
      description: Register a URL to receive event notifications.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - url
              - events
              properties:
                url:
                  type: string
                  format: uri
                  description: HTTPS URL to deliver events to. Must be publicly accessible.
                events:
                  type: array
                  items:
                    $ref: '#/components/schemas/WebhookEventType'
                  description: Event types to subscribe to. Use ["*"] to receive all events.
                secret:
                  type: string
                  description: Signing secret used to verify webhook payloads. If provided, each delivery includes an X-Autoposting-Signature header with an HMAC-SHA256 signature.
                enabled:
                  type: boolean
                  default: true
                  description: 'Whether the webhook is active. Default: true.'
              example:
                url: https://your-server.com/webhooks/autoposting
                events:
                - post.published
                - post.failed
                - clip.render.completed
                secret: whsec_your_signing_secret
      responses:
        '200':
          description: Webhook created
          content:
            application/json:
              schema:
                type: object
                required:
                - success
                - data
                properties:
                  success:
                    type: boolean
                  data:
                    $ref: '#/components/schemas/Webhook'
                example:
                  success: true
                  data:
                    id: wh_01HXYZ
                    url: https://your-server.com/webhooks/autoposting
                    events:
                    - post.published
                    - post.failed
                    - clip.render.completed
                    enabled: true
                    createdAt: '2024-01-01T00:00:00Z'
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                type: object
                required:
                - success
                - error
                - message
                properties:
                  success:
                    type: boolean
                  error:
                    type: string
                  message:
                    type: string
                example:
                  success: false
                  error: unauthorized
                  message: Missing or invalid API key
    get:
      tags:
      - Webhooks
      operationId: listWebhooks
      summary: List webhook endpoints
      responses:
        '200':
          description: List of webhook endpoints
          content:
            application/json:
              schema:
                type: object
                required:
                - success
                - data
                properties:
                  success:
                    type: boolean
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Webhook'
                example:
                  success: true
                  data:
                  - id: wh_01HXYZ
                    url: https://your-server.com/webhooks/autoposting
                    events:
                    - post.published
                    - post.failed
                    enabled: true
                    lastDeliveryAt: '2024-01-10T09:05:00Z'
                    lastDeliveryStatus: success
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                type: object
                required:
                - success
                - error
                - message
                properties:
                  success:
                    type: boolean
                  error:
                    type: string
                  message:
                    type: string
                example:
                  success: false
                  error: unauthorized
                  message: Missing or invalid API key
  /webhooks/{webhookId}:
    patch:
      tags:
      - Webhooks
      operationId: updateWebhook
      summary: Update a webhook
      parameters:
      - name: webhookId
        in: path
        required: true
        schema:
          type: string
        example: wh_01HXYZ
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                url:
                  type: string
                  format: uri
                  description: New delivery URL.
                events:
                  type: array
                  items:
                    $ref: '#/components/schemas/WebhookEventType'
                  description: Updated event subscriptions.
                secret:
                  type: string
                  description: Updated signing secret.
                enabled:
                  type: boolean
                  description: Enable or disable the webhook.
      responses:
        '200':
          description: Webhook updated
          content:
            application/json:
              schema:
                type: object
                required:
                - success
                - data
                properties:
                  success:
                    type: boolean
                  data:
                    $ref: '#/components/schemas/Webhook'
                example:
                  success: true
                  data:
                    id: wh_01HXYZ
                    url: https://your-server.com/webhooks/autoposting
                    events:
                    - post.published
                    - post.failed
                    - clip.render.completed
                    enabled: true
                    createdAt: '2024-01-01T00:00:00Z'
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                type: object
                required:
                - success
                - error
                - message
                properties:
                  success:
                    type: boolean
                  error:
                    type: string
                  message:
                    type: string
                example:
                  success: false
                  error: unauthorized
                  message: Missing or invalid API key
    delete:
      tags:
      - Webhooks
      operationId: deleteWebhook
      summary: Delete a webhook
      parameters:
      - name: webhookId
        in: path
        required: true
        schema:
          type: string
        example: wh_01HXYZ
      responses:
        '200':
          description: Webhook deleted
          content:
            application/json:
              schema:
                type: object
                required:
                - success
                - data
                properties:
                  success:
                    type: boolean
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                      deleted:
                        type: boolean
                example:
                  success: true
                  data:
                    id: wh_01HXYZ
                    deleted: true
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                type: object
                required:
                - success
                - error
                - message
                properties:
                  success:
                    type: boolean
                  error:
                    type: string
                  message:
                    type: string
                example:
                  success: false
                  error: unauthorized
                  message: Missing or invalid API key
  /webhooks/{webhookId}/test:
    post:
      tags:
      - Webhooks
      operationId: testWebhook
      summary: Send a test delivery
      description: Sends a synthetic webhook.test event to the configured URL to verify connectivity and your handler logic.
      parameters:
      - name: webhookId
        in: path
        required: true
        schema:
          type: string
        example: wh_01HXYZ
      responses:
        '200':
          description: Test delivery result
          content:
            application/json:
              schema:
                type: object
                required:
                - success
                - data
                properties:
                  success:
                    type: boolean
                  data:
                    type: object
                    properties:
                      deliveryId:
                        type: string
                      status:
                        type: string
                      responseStatus:
                        type: integer
                example:
                  success: true
                  data:
                    deliveryId: del_01HXYZ
                    status: delivered
                    responseStatus: 200
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                type: object
                required:
                - success
                - error
                - message
                properties:
                  success:
                    type: boolean
                  error:
                    type: string
                  message:
                    type: string
                example:
                  success: false
                  error: unauthorized
                  message: Missing or invalid API key
  /webhooks/{webhookId}/deliveries:
    get:
      tags:
      - Webhooks
      operationId: listWebhookDeliveries
      summary: List delivery history
      parameters:
      - name: webhookId
        in: path
        required: true
        schema:
          type: string
        example: wh_01HXYZ
      - name: limit
        in: query
        required: false
        description: 'Items per page. Default: 50.'
        schema:
          type: number
          default: 50
      - name: offset
        in: query
        required: false
        description: 'Items to skip. Default: 0.'
        schema:
          type: number
          default: 0
      responses:
        '200':
          description: Delivery history
          content:
            application/json:
              schema:
                type: object
                required:
                - success
                - data
                properties:
                  success:
                    type: boolean
                  data:
                    type: object
                    properties:
                      deliveries:
                        type: array
                        items:
                          $ref: '#/components/schemas/WebhookDelivery'
                      total:
                        type: integer
                example:
                  success: true
                  data:
                    deliveries:
                    - id: del_01HXYZ
                      eventType: post.published
                      status: success
                      responseStatus: 200
                      attemptCount: 1
                      deliveredAt: '2024-01-10T09:05:00Z'
                    - id: del_02HXYZ
                      eventType: post.failed
                      status: failed
                      responseStatus: 500
                      attemptCount: 3
                      deliveredAt: '2024-01-10T10:00:00Z'
                    total: 2
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                type: object
                required:
                - success
                - error
                - message
                properties:
                  success:
                    type: boolean
                  error:
                    type: string
                  message:
                    type: string
                example:
                  success: false
                  error: unauthorized
                  message: Missing or invalid API key
components:
  schemas:
    Webhook:
      type: object
      required:
      - id
      - url
      - events
      - enabled
      properties:
        id:
          type: string
          example: wh_01HXYZ
        url:
          type: string
          format: uri
          example: https://your-server.com/webhooks/autoposting
        events:
          type: array
          items:
            $ref: '#/components/schemas/WebhookEventType'
        enabled:
          type: boolean
          example: true
        createdAt:
          type: string
          format: date-time
          example: '2024-01-01T00:00:00Z'
        lastDeliveryAt:
          type: string
          format: date-time
          example: '2024-01-10T09:05:00Z'
        lastDeliveryStatus:
          type: string
          example: success
    WebhookDelivery:
      type: object
      required:
      - id
      - eventType
      - status
      properties:
        id:
          type: string
          example: del_01HXYZ
        eventType:
          $ref: '#/components/schemas/WebhookEventType'
        status:
          type: string
          enum:
          - success
          - failed
          example: success
        responseStatus:
          type: integer
          example: 200
        attemptCount:
          type: integer
          example: 1
        deliveredAt:
          type: string
          format: date-time
          example: '2024-01-10T09:05:00Z'
    WebhookEventType:
      type: string
      description: Webhook event type. Use "*" to subscribe to all events.
      enum:
      - post.published
      - post.failed
      - post.scheduled
      - clip.render.completed
      - clip.render.failed
      - agent.run.completed
      - agent.run.failed
      - '*'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'API key as `Authorization: Bearer sk-social-...`'
    apiKeyHeader:
      type: apiKey
      in: header
      name: x-api-key
      description: 'API key as `x-api-key: sk-social-...`'