---
title: "Dribbble API: post and schedule from code"
url: "https://get1post.com/developers/dribbble.md"
canonical_url: "https://get1post.com/developers/dribbble"
last_updated: "2026-10-26"
type: "reference"
summary: "Post and schedule to Dribbble with the 1Post API and MCP server: the request, the reply, every rule it is checked against and a dry run."
related: ["https://get1post.com/platforms/dribbble.md", "https://get1post.com/platforms/dribbble/specs.md", "https://get1post.com/docs/api-posts.md", "https://get1post.com/docs/mcp.md"]
---

# Dribbble API: post and schedule from code

Post and schedule to Dribbble with the 1Post API and MCP server: the request, the reply, every rule it is checked against and a dry run.

Post to Dribbble from code with one request: POST /v1/posts with your account id, the text and a schedule_at time. Dribbble has no text length that 1Post checks. 1Post allows up to 5 posts a day for each connected account, and a dry run checks a post against every rule first.

## Connect Dribbble first

1. Open Accounts in 1Post and choose Connect.
2. Pick Dribbble.
3. Sign in with Dribbble and approve access for the account you want to post to.
4. Choose the account in 1Post. It is ready to pick in the composer.

Then GET /v1/accounts returns the id of the Dribbble account to use in the request.

## Send a post to Dribbble

Dribbble refuses a post without media, so upload the file first and put its id in media_ids (POST /v1/media/uploads, or POST /v1/media to fetch a public address). Then schedule the post.

**Schedule a post**

```bash
curl https://api.get1post.com/v1/posts \
  -H "Authorization: Bearer $ONEPOST_API_KEY" \
  -H "Idempotency-Key: dribbble-first-post" \
  -d '{"accounts":["ACCOUNT_ID"],"parts":[{"text":"Dashboard concept, light mode.","media_ids":["MEDIA_ID"]}],"schedule_at":"2026-11-02T15:00:00Z"}'
```

The reply is 202 with the post (status scheduled) and one destination for Dribbble, which moves from queued to published or failed.

## What you can send to Dribbble

- One image shot, exactly 400 x 300 or 800 x 600 pixels

## Dribbble rules the request is checked against

| Rule | What 1Post checks |
| --- | --- |
| Text limit | No length check |
| Media accepted | Images |
| Images per post | 1 |
| Image size in pixels | 400 x 300 or 800 x 600 |
| Threads | No |
| First comment | No |
| Posts per day, per connected account (1Post) | 5 |

The same table with sources is on the [Dribbble specs page](https://get1post.com/platforms/dribbble/specs.md).

## Dribbble options in the request

- Media is required: Dribbble refuses a post without it. Upload the file first (POST /v1/media/uploads, or POST /v1/media to fetch a public address) and list its id in the media_ids of a part.

## Check the post before it is queued

Add "dry_run": true to test a post: nothing is kept, a valid one answers 200 and a broken one answers 422 naming the rule.

**A refused request, abridged**

```json
{
  "error": {
    "code": "invalid_for_platform",
    "message": "dribbble refuses this post: Dribbble needs some content. (empty_text).",
    "fix": "Fix the rule named in the message and send the post again.",
    "retryable": false,
    "request_id": "REQUEST_ID"
  }
}
```

An assistant connected to the [MCP server](https://get1post.com/docs/mcp.md) sends the same fields to create_post; [set one up](https://get1post.com/assistants.md).

## Questions

**Can I post to Dribbble with an API key?**

Yes. A key with write scope can create, change and cancel Dribbble posts for the workspace it belongs to, with the role of the member who made it. See [API authentication](https://get1post.com/docs/api-authentication.md).

**What happens if a Dribbble post breaks a rule?**

The request is refused with invalid_for_platform and the failing rule is named. Fix it and send the request again, or send it with dry_run to test the fix first.

**How many Dribbble posts can I send in a day?**

Up to 5 for each connected account. A request that would pass that answers daily_cap with the time the day frees up.

## Related

- [Schedule Dribbble posts: formats, limits, setup](https://get1post.com/platforms/dribbble.md)
- [Dribbble specs and limits: text, media, daily cap](https://get1post.com/platforms/dribbble/specs.md)
- [Creating and changing posts with the API: 1Post docs](https://get1post.com/docs/api-posts.md)
- [The MCP server: 1Post docs](https://get1post.com/docs/mcp.md)