Name: Hookpost Social Scheduler API | One call, many networks
Brand: hookstep
SKU: api-hookstep-hookpost
Availability: InStock
Author: API Market

Jatinder Mahajan

# Hookpost Social Scheduler API

## Overview

The Hookpost Social Scheduler API publishes and schedules one post to several social networks at once: LinkedIn, X, Threads, Facebook, Instagram, YouTube, Pinterest, Discord and Slack. Fourteen endpoints list the networks and their rules, connect your own accounts with a sign-in link, upload media, create, validate, read and delete posts, find the next free time slot for a channel, and report notifications and plan usage.

It is built for developers adding social publishing to their apps, agencies and marketers scheduling content across many accounts, and AI agents that draft and schedule posts. You never need a Hookpost account or key: your first call creates a private workspace for your API Market subscription, and only you can see its channels, media and posts.

## Features

*   **14 endpoints**: networks, account connection, channels, media, posts, validation, time slots, notifications and usage.
*   **9 networks**: LinkedIn, X, Threads, Facebook, Instagram, YouTube, Pinterest, Discord and Slack.
*   **Network rules up front**: `/providers` returns each network's character limit, media rules, credits and settings.
*   **Validate before posting**: `/posts/validate` checks a post against every target channel without publishing.
*   **Private workspace**: channels, media and posts are scoped to your subscription.
*   **Rate limit**: up to 10 requests per second.

## Use Cases

*   **SaaS apps**: let users schedule posts to their own social accounts from inside your product.
*   **Agencies**: publish one campaign to many networks in a single call.
*   **AI content agents**: draft posts, validate them and schedule them at the next free slot.
*   **Content calendars**: read scheduled posts and notifications to keep a calendar in sync.

## API Documentation

### Base URL

All requests go through the API.market gateway at this base URL:

```
https://prod.api.market/api/v1/hookstep/hookpost
```

### Authentication

Every request needs your API.market key in the `x-api-market-key` header:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key.

### Endpoints

#### 1. Networks, limits and settings

Every network this API posts to, with its character limit, media rules, credits and the settings it takes. Needs no connected account. 0 credits.

**Method:** `GET`

**Endpoint:** `/providers`

**Parameters:**

This endpoint takes no parameters.

**Example Request:**

```bash
curl -X GET 'https://prod.api.market/api/v1/hookstep/hookpost/providers' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

**Example Response (200 OK (trimmed)):**

Long lists are cut to their first items and long text is shortened.

```json
{
  "providers": [
    {
      "identifier": "x",
      "name": "X",
      "max_chars": 280,
      "counting": "weighted",
      "media": {
        "min": 0,
        "max": 4,
        "video_alone": true,
        "requires_video": false
      },
      "connect": true,
      "picks_page_after_login": false,
      "credits": {
        "per_tweet": 2,
        "per_tweet_with_link": 20
      },
      "included_in_plan": true,
      "settings": {
        "properties": {
          "community": {
            "pattern": "^(https:\\/\\/x\\.com\\/i\\/communities\\/\\d+)?$",
            "type": "string"
          },
          "who_can_reply_post": {
            "type": "string",
            "enum": [
              "everyone",
              "following"
            ]
          },
          "post_type": {
            "type": "string",
            "enum": [
              "post",
              "article"
            ],
            "description": "post = a regular short post (plain text). article = a long-form X article: write the post content as HTML (p, h1, h2, h3, ul, ol, li, strong, u, a) - the formatting is kept in the article"
          },
          "article_title": {
            "minLength": 1,
            "type": "string",
            "description": "The title of the article, required when post_type is article"
          },
          "article_status": {
            "type": "string",
            "enum": [
              "draft",
              "published"
            ],
            "description": "draft = save the article as a draft on X, published = publish it right away, required when post_type is article"
          },
          "article_cover": {
            "properties": {
              "id": {
                "not": {
                  "type": "null"
                },
                "type": "string"
              },
              "path": {
                "type": "string",
                "not": {
                  "type": "null"
                }
              },
              "alt": {
                "type": "string"
              },
              "thumbnail": {
                "format": "url",
                "type": "string"
              }
            },
            "type": "object",
            "required": [
              "id",
              "path"
            ],
            "description": "Optional cover image for the article, only used when post_type is article"
          },
          "made_with_ai": {
            "type": "boolean"
          },
          "paid_partnership": {
            "type": "boolean"
          }
        },
        "type": "object"
      }
    },
    {
      "identifier": "linkedin",
      "name": "LinkedIn (personal profile)",
      "max_chars": 3000,
      "counting": "characters",
      "media": {
        "min": 0,
        "max": null,
        "video_alone": true,
        "requires_video": false
      },
      "connect": true,
      "picks_page_after_login": false,
      "credits": {
        "per_post": 1
      },
      "included_in_plan": true,
      "settings": {
        "properties": {
          "post_as_images_carousel": {
            "type": "boolean"
          },
          "carousel_name": {
            "type": "string"
          }
        },
        "type": "object"
      }
    }
  ]
}
```

#### 2. Get a link to connect an account

Returns a sign-in link for your own account on the network. Open it in a browser; when it says "connected", the channel is in GET /channels. The link works once, for an hour, and acts like a password. 0 credits.

**Method:** `GET`

**Endpoint:** `/connect/{provider}`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| provider | path | A network from GET /providers, e.g. linkedin, x, threads. | string | Yes | - | - |
| reconnect | query | A channel id: connect that channel again (after needs_reconnect). | string | No | - | - |

**Example Request:**

```bash
curl -X GET 'https://prod.api.market/api/v1/hookstep/hookpost/connect/x' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

**Example Response (200 OK):**

```json
{
  "provider": "x",
  "url": "https://api.x.com/oauth/authenticate?oauth_token=...&force_login=false",
  "expires_in": 3600
}
```

#### 3. List connected channels

Your workspace's connected accounts. 0 credits.

**Method:** `GET`

**Endpoint:** `/channels`

**Parameters:**

This endpoint takes no parameters.

**Example Request:**

```bash
curl -X GET 'https://prod.api.market/api/v1/hookstep/hookpost/channels' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

**Example Response (200 OK):**

```json
{
  "channels": [],
  "included": 20
}
```

#### 4. Disconnect a channel

Removes the channel and its posts that have not published. Frees a channel slot. 0 credits.

**Method:** `DELETE`

**Endpoint:** `/channels/{id}`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| id | path | Channel id from GET /channels. | string | Yes | - | - |

**Example Request:**

```bash
curl -X DELETE 'https://prod.api.market/api/v1/hookstep/hookpost/channels/test' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

#### 5. Upload an image or video

Stores a file in your workspace for posts (media_ids). 0 credits; counts toward your plan's storage. Media is removed 45 days after upload.

**Method:** `POST`

**Endpoint:** `/media`

**Parameters:**

This endpoint takes no parameters.

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/hookstep/hookpost/media' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

#### 6. Upload media from a URL

Fetches a public image or video into your workspace. 0 credits; counts toward storage.

**Method:** `POST`

**Endpoint:** `/media/from-url`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| url | body | A public http(s) URL of the image or video. | string | Yes | - | - |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/hookstep/hookpost/media/from-url' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"url": "https://example.com/photo.jpg"}'
```

#### 7. List posts in a time range

Posts publishing between from and to (at most 92 days; default: the last 7 and next 35 days). 0 credits.

**Method:** `GET`

**Endpoint:** `/posts`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| from | query | ISO 8601 start. | string | No | - | - |
| to | query | ISO 8601 end. | string | No | - | - |

**Example Request:**

```bash
curl -X GET 'https://prod.api.market/api/v1/hookstep/hookpost/posts' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

**Example Response (200 OK):**

```json
{
  "posts": []
}
```

#### 8. Schedule a post on one or more channels

The same content goes to every channel; content[0] is the post and content[1..] its thread replies (X tweets, Threads replies). Credits: 1 per channel, X 2 per tweet or 20 per tweet with a link. Held when accepted and not returned on cancel.

**Method:** `POST`

**Endpoint:** `/posts`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| channels | body | - | array of object | Yes | - | 20 |
| content | body | - | array of object | Yes | - | 25 |
| schedule_at | body | When to publish: an ISO 8601 time with a zone ("2026-11-02T09:30:00Z"), "now", or "draft". Trials schedule up to 7 days ahead, paid plans up to 35. | string | Yes | - | - |
| link_policy | body | X only. "reject" (the default) refuses a tweet with a link with a 400, so you are never charged by surprise. "allow" posts it at 20 credits a tweet (X charges more for posts with links). | string | No | reject | - |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/hookstep/hookpost/posts' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"channels": [{"id": "clx123channel"}, {"id": "clx456channel", "settings": {"who_can_reply_post": "everyone"}}], "content": [{"text": "We shipped a new release today.", "media_ids": []}], "schedule_at": "2026-11-02T09:30:00Z"}'
```

#### 9. Check and price a post without saving it

Runs every check POST /posts runs and returns the credits it would cost. Saves nothing. 0 credits.

**Method:** `POST`

**Endpoint:** `/posts/validate`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| channels | body | - | array of object | Yes | - | 20 |
| content | body | - | array of object | Yes | - | 25 |
| schedule_at | body | When to publish: an ISO 8601 time with a zone ("2026-11-02T09:30:00Z"), "now", or "draft". Trials schedule up to 7 days ahead, paid plans up to 35. | string | Yes | - | - |
| link_policy | body | X only. "reject" (the default) refuses a tweet with a link with a 400, so you are never charged by surprise. "allow" posts it at 20 credits a tweet (X charges more for posts with links). | string | No | reject | - |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/hookstep/hookpost/posts/validate' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"channels": [{"id": "test"}], "content": [{"text": "test"}], "schedule_at": "2026-11-02T09:30:00Z", "link_policy": "reject"}'
```

#### 10. Status of a post

scheduled, published (with its URL) or error (with the reason). 0 credits.

**Method:** `GET`

**Endpoint:** `/posts/{id}`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| id | path | The id from the post you created. | string | Yes | - | - |

**Example Request:**

```bash
curl -X GET 'https://prod.api.market/api/v1/hookstep/hookpost/posts/test' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

#### 11. Cancel a post before it publishes

Cancels it on its channel. Credits are not returned once a post is accepted. A published post can only be deleted on the network. 0 credits.

**Method:** `DELETE`

**Endpoint:** `/posts/{id}`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| id | path | The id from the post you created. | string | Yes | - | - |

**Example Request:**

```bash
curl -X DELETE 'https://prod.api.market/api/v1/hookstep/hookpost/posts/test' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

#### 12. Next open time slot of a channel

The next of the channel's posting times that has no post yet. 0 credits.

**Method:** `GET`

**Endpoint:** `/slots/{channel_id}`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| channel_id | path | Channel id. | string | Yes | - | - |

**Example Request:**

```bash
curl -X GET 'https://prod.api.market/api/v1/hookstep/hookpost/slots/test' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

#### 13. Workspace notifications

Publishing errors and notices of your workspace, newest first, 100 a page. 0 credits.

**Method:** `GET`

**Endpoint:** `/notifications`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| page | query | Page, from 0. | integer | No | - | - |

**Example Request:**

```bash
curl -X GET 'https://prod.api.market/api/v1/hookstep/hookpost/notifications' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

**Example Response (200 OK):**

```json
{
  "notifications": [],
  "has_more": false
}
```

#### 14. Credits, channels and storage used

Our own counters for the current 28-day window, which starts at your first call and need not match api.market's month. api.market's dashboard is the billing record. 0 credits.

**Method:** `GET`

**Endpoint:** `/usage`

**Parameters:**

This endpoint takes no parameters.

**Example Request:**

```bash
curl -X GET 'https://prod.api.market/api/v1/hookstep/hookpost/usage' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

**Example Response (200 OK):**

```json
{
  "product": "social",
  "plan": "pro",
  "plan_name": "Social Scheduler Pro",
  "window_start": "2026-10-26T15:02:05.248Z",
  "window_end": "2026-11-23T15:02:05.248Z",
  "credits_included": 1200,
  "credits_used": 0,
  "channels_included": 20,
  "channels_used": 0,
  "storage_included_bytes": 10737418240,
  "storage_used_bytes": 0,
  "schedule_horizon_days": 35,
  "x_included": true,
  "x_links_included": true,
  "thread_cap": 25,
  "note": "api.market bills and limits your plan; these are our own counters."
}
```

## Status Codes

| Code | Status | Description |
|---|---|---|
| 200 | OK | The request succeeded and the body holds the result. |
| 400 | Bad Request | The body is not valid JSON, a required field is missing, or the provider name is not one this API supports. |
| 401 | Unauthorized | The `x-api-market-key` header is missing, invalid or expired. |
| 403 | Forbidden | Your subscription does not include this endpoint. |
| 404 | Not Found | The path, or the item you asked for, does not exist. |
| 429 | Too Many Requests | You sent more than 10 requests per second, or you used all 10 calls of the Free plan. |
| 500 | Internal Server Error | Something failed on the provider side. Retry after a short delay. |
| 503 | Service Unavailable | The service or its data source is temporarily unavailable. Retry with backoff. |

## Rate Limits

You can send up to 10 requests per second. Free includes 10 calls (a 7-day trial), Standard includes 500 calls a month for $19 and Pro includes 1,200 calls a month for $39. Requests above the limit return `429 Too Many Requests`; throttle your requests, back off before retrying, and honour the `Retry-After` header when it is present.

## FAQ

*   **How do I connect an account?**
    Call `GET /connect/{provider}` with a network from `/providers`, open the returned link in a browser and sign in. The channel then appears in `GET /channels`. The link works once and expires after an hour.

*   **Do I need a Hookpost account?**
    No. Your API Market key is all you need; do not send any other `Authorization` header.

*   **How are credits counted?**
    `/providers` lists the credits each network uses per post, and `GET /usage` shows credits included and used in your plan window.

*   **What happens to uploaded media?**
    Media counts toward your plan's storage and is removed 45 days after upload.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.


Schedule one post to LinkedIn, X, Threads, Facebook, Instagram, YouTube, Pinterest, Discord and Slack in one API call. 7-day trial, then from $19/month.

Hookpost Social Scheduler API | One call, many networks

Free

Hookstep

Standard

Schedule one post to LinkedIn, X, Threads, Facebook, Instagram, YouTube, Pinterest, Discord and Slack in one call. Accounts connect with a sign-in link.