> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dohoo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Threads Posting API for Automated Posts | Dohoo

> Use the Dohoo Threads posting API to publish authenticated text posts programmatically through a connected account.

The Threads Publish endpoint lets you post text content to Threads, Meta's conversation-focused platform, through the Dohoo API. Because Threads accounts are tied to Instagram, you connect Threads by linking your Instagram account in the Dohoo dashboard — no separate OAuth flow is required. Once connected, pass the Threads connection ID and your post text to publish immediately.

## Endpoint

```
POST https://dohoo.ai/api/v2/threads/publish
```

## Request headers

| Header         | Required | Description                |
| -------------- | -------- | -------------------------- |
| `X-API-Key`    | ✅        | Your Dohoo API key         |
| `Content-Type` | ✅        | Must be `application/json` |

## Request body

| Field          | Type   | Required | Description                                      |
| -------------- | ------ | -------- | ------------------------------------------------ |
| `connectionId` | string | ✅        | The ID of the Threads connection to publish from |
| `text`         | string | ✅        | The text content of the Threads post             |

## Example request

```bash theme={null}
curl -X POST https://dohoo.ai/api/v2/threads/publish \
  -H "X-API-Key: dh_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "connectionId": "conn_threads_001",
    "text": "Your Threads post content here."
  }'
```

## Example response

```json theme={null}
{
  "success": true,
  "platform": "threads",
  "postId": "18023456789012345",
  "connectionId": "conn_threads_001",
  "status": "published",
  "publishedAt": "2025-01-15T17:55:00Z",
  "url": "https://www.threads.net/@yourhandle/post/ABC123xyz"
}
```

<Note>
  Your Threads connection is **linked to your Instagram account**. To enable Threads publishing, connect your Instagram account in the Dohoo dashboard first. Once Instagram is connected, a corresponding Threads connection will appear automatically.
</Note>

<Tip>
  Threads posts can be up to 500 characters. Keep your posts conversational — Threads is designed for public discussions and replies, so content that invites engagement tends to perform well.
</Tip>

<Warning>
  If your Instagram account is disconnected or its access token expires, your Threads connection will also become inactive. Reconnect Instagram in the **Connections** page of your Dohoo dashboard to restore access for both platforms.
</Warning>