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

# Dribbble Settings

> API settings for posting to Dribbble

Creating the OAuth app and connecting a channel: [Dribbble setup guide](/installation/providers/dribbble).

## Settings Schema

When creating a shot on Dribbble, use the following settings schema:

```json theme={"system"}
{
  "settings": {
    "__type": "dribbble",
    "title": "My Shot Title",
    "team": ""
  }
}
```

## Fields

| Field    | Type     | Required | Description                                          |
| -------- | -------- | -------- | ---------------------------------------------------- |
| `__type` | `string` | Yes      | Must be `dribbble`                                   |
| `title`  | `string` | Yes      | Shot title (min 1 character)                         |
| `team`   | `string` | No       | Accepted and validated, but not used when publishing |

### `title`

Required title for your Dribbble shot. This is displayed prominently on your shot.

### `team`

Validated as a URL if you send it, and then ignored. The publish path never reads it, so the shot is always created on the authenticated Dribbble account. Posting on behalf of a team is not supported through the API today.

***

## Complete Example

### Personal Shot

```json theme={"system"}
{
  "type": "schedule",
  "date": "2024-12-14T10:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": {
        "id": "your-dribbble-integration-id"
      },
      "value": [
        {
          "content": "New dashboard design concept exploring dark mode aesthetics and modern UI patterns. Built with Figma.\n\n#ui #ux #dashboard #darkmode #design",
          "image": [
            {
              "id": "shot-image-id",
              "path": "https://uploads.postqueen.ai/dashboard-design.png"
            }
          ]
        }
      ],
      "settings": {
        "__type": "dribbble",
        "title": "Dashboard UI - Dark Mode Concept",
        "team": ""
      }
    }
  ]
}
```

### Team Shot

```json theme={"system"}
{
  "type": "schedule",
  "date": "2024-12-14T10:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": {
        "id": "your-dribbble-integration-id"
      },
      "value": [
        {
          "content": "Our latest branding project for TechCorp. Full case study coming soon!\n\n#branding #logo #identity",
          "image": [
            {
              "id": "branding-image-id",
              "path": "https://uploads.postqueen.ai/branding.png"
            }
          ]
        }
      ],
      "settings": {
        "__type": "dribbble",
        "title": "TechCorp Brand Identity",
        "team": "https://dribbble.com/teams/my-design-team"
      }
    }
  ]
}
```

### Mobile App Design

```json theme={"system"}
{
  "type": "now",
  "date": "2024-12-14T10:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": {
        "id": "your-dribbble-integration-id"
      },
      "value": [
        {
          "content": "Fitness tracking app concept with focus on clean data visualization and motivational design elements.\n\nSwipe to see all screens →\n\n#mobileapp #fitness #appdesign #ios",
          "image": [
            {
              "id": "app-screen-1",
              "path": "https://uploads.postqueen.ai/fitness-1.png"
            },
            {
              "id": "app-screen-2",
              "path": "https://uploads.postqueen.ai/fitness-2.png"
            }
          ]
        }
      ],
      "settings": {
        "__type": "dribbble",
        "title": "Fitness App - UI/UX Design",
        "team": ""
      }
    }
  ]
}
```

<Note>
  **Dribbble Tips:**

  * Use high-quality images (800×600 or larger recommended)
  * Include relevant tags in your description
  * Add context about your design process in the content
</Note>
