Docs
Open Lodol
DocumentationIntegrationsAPI

Dribbble

App · Images & Design · 10 actions

Show and tell for designers. Read the connected Dribbble account and its shots, publish a new shot from an image an earlier step produced, retitle or retag an existing one, and manage the projects a profile files its work under.

Actions

ActionWhat it does
Create a projectCreate a project on the connected Dribbble account: a named group that shots can be filed under, shown as its own tab on the profile.
Create a shotPublish a new shot to the connected Dribbble account.
Delete a projectRemove a project from the connected Dribbble account.
Delete a shotPermanently remove a shot from the connected Dribbble account.
Get a shotGet one shot in full by its id: title, description, tags, dimensions, the image at each size Dribbble keeps, whether it is animated, whether it is low profile, and when it was published and last changed.
Get my Dribbble accountGet the Dribbble account this integration is connected as: its username, display name, bio, location, profile and avatar addresses, follower count, whether it is Pro, whether it may publish a shot right now, and the teams it belongs to.
List my projectsList the projects on the connected Dribbble account (the named groups a designer files shots under) with each project's id, name, description and shot count.
List my shotsList the shots on the connected Dribbble account, newest first, with each shot's id, title, description, tags, image addresses and publication date.
Update a projectRename a project on the connected Dribbble account, change its description, or both.
Update a shotChange a shot you own: its title, description, tags, low profile setting, scheduled publication time, or the team it is published under.

Create a project

Create a project on the connected Dribbble account: a named group that shots can be filed under, shown as its own tab on the profile. Answers with the new project, including its id.

Inputs

NamenametextRequired
The project's name, shown on your profile.
Descriptiondescriptiontext
Optional. What the project is about.

Outputs

A Dribbble project: a named group of shots on a profile.

created_attext
ISO 8601 timestamp of when the project was created.
descriptiontext
The project's description.
idnumber
Unique project id.
nametext
The project's name.
shots_countnumber
How many shots are in the project.
updated_attext
ISO 8601 timestamp of the project's last change.
Example output
{
  "created_at": "2011-04-14T03:43:47Z",
  "description": "Visual design and art direction for this project.",
  "id": 3,
  "name": "Web Standards Sherpa",
  "shots_count": 4,
  "updated_at": "2012-04-04T22:39:53Z"
}

Create a shot

Publish a new shot to the connected Dribbble account. The image must be exactly 400x300 or 800x600 pixels, no larger than 8 MB, and a GIF, JPG or PNG; all three are checked before it is sent. Dribbble processes the image in the background, so this answers with the new shot's id and page address rather than the finished shot; read it back with 'Get a shot'. Needs the 'upload' permission, which the connect step asks for.

Inputs

ImageimagetextRequired
The shot image: upload a file, pick an image from an earlier step, or paste a public image URL. Must be exactly 400x300 or 800x600 pixels and a GIF, JPG or PNG.
TitletitletextRequired
The shot's title, shown under the image.
Descriptiondescriptiontext
Optional. The text shown below the shot. Basic HTML is allowed.
Tagstagslist
Tags describing the shot, used by Dribbble's search and browse pages. Up to 12; blanks and repeats are dropped.
Low profilelow_profiletrue/false
Keep the shot off your followers' feeds and Dribbble's browse pages. It stays on your profile and anyone with the link can still see it, which is what to use for a test post.
Publish atscheduled_fordate and time
Publish the shot at this date and time instead of straight away. Leave blank to publish immediately. Scheduling is a Dribbble Pro feature.
Rebound ofrebound_source_idtext
Optional. Post this as a rebound (a reply) to another shot. Paste that shot's id or the address of its page.
Teamteamtext
Publish the shot under one of your Dribbble teams instead of your own profile. Leave blank to post as yourself. The list holds the teams this account belongs to.

Outputs

The shot Dribbble accepted. Its image is still being processed, so only the fields known at upload time are returned; read the finished shot with 'Get a shot'.

heightnumber
Height of the uploaded image in pixels.
html_urltext
Address of the new shot's page.
idnumber
The new shot's id.
processingtrue/false
Always true: Dribbble renders the image after accepting it.
titletext
The title that was sent.
widthnumber
Width of the uploaded image in pixels.
Example output
{
  "height": 300,
  "html_url": "https://dribbble.com/shots/471756",
  "id": 471756,
  "processing": true,
  "title": "Sasquatch",
  "width": 400
}

Delete a project

Remove a project from the connected Dribbble account. The shots that were filed under it stay on the profile: only the grouping is removed.

Inputs

Projectproject_idtextRequired
Which of your projects to act on. The list holds this account's own projects; you can also paste a project id.

Outputs

Confirmation that the record was removed.

deletedtrue/false
Always true: Dribbble answers a delete with no content.
idnumber
The id that was deleted.
Example output
{
  "deleted": true,
  "id": 3
}

Delete a shot

Permanently remove a shot from the connected Dribbble account. This cannot be undone, and Dribbble does not return the shot's contents on the way out, so read it with 'Get a shot' first if you need to keep a copy. Needs the 'upload' permission.

Inputs

Shotshot_idtextRequired
Which of your shots to act on. The list holds this account's own shots, newest first; you can also paste a shot id or the address of the shot's page.

Outputs

Confirmation that the record was removed.

deletedtrue/false
Always true: Dribbble answers a delete with no content.
idnumber
The id that was deleted.
Example output
{
  "deleted": true,
  "id": 471756
}

Get a shot

Get one shot in full by its id: title, description, tags, dimensions, the image at each size Dribbble keeps, whether it is animated, whether it is low profile, and when it was published and last changed.

Inputs

Shotshot_idtextRequired
The shot to read. Paste its id (471756) or the address of its page (https://dribbble.com/shots/471756-Sasquatch); the id is taken out of the address for you.

Outputs

A Dribbble shot.

animatedtrue/false
Whether the highest-resolution image is animated.
descriptiontext
The shot's description, as HTML.
heightnumber
Image height in pixels.
html_urltext
Address of the shot's page.
idnumber
Unique shot id.
imagesobject
The rendered image at each size Dribbble keeps.
low_profiletrue/false
Whether the shot is hidden from followers' feeds and browse pages.
published_attext
ISO 8601 timestamp of when the shot went live.
tagslist
The shot's tags.
titletext
The shot's title.
updated_attext
ISO 8601 timestamp of the shot's last change.
widthnumber
Image width in pixels.
Example output
{
  "animated": false,
  "description": "<p>Quick, messy, five minute sketch.</p>",
  "height": 300,
  "html_url": "https://dribbble.com/shots/471756-Sasquatch",
  "id": 471756,
  "images": {
    "hidpi": null,
    "normal": "https://cdn.dribbble.com/users/1/screenshots/471756/sasquatch.png",
    "teaser": "https://cdn.dribbble.com/users/1/screenshots/471756/sasquatch_teaser.png"
  },
  "low_profile": false,
  "published_at": "2012-03-15T01:52:33Z",
  "tags": [
    "fiction",
    "sasquatch",
    "sketch",
    "wip"
  ],
  "title": "Sasquatch",
  "updated_at": "2012-03-15T02:12:57Z",
  "width": 400
}

Get my Dribbble account

Get the Dribbble account this integration is connected as: its username, display name, bio, location, profile and avatar addresses, follower count, whether it is Pro, whether it may publish a shot right now, and the teams it belongs to. Useful as a connection check, and for reading the team ids that 'Create a shot' can publish under.

Inputs

None.

Outputs

The Dribbble account the connection acts as.

avatar_urltext
Avatar image URL.
biotext
Profile biography.
can_upload_shottrue/false
Whether this account may publish a shot right now. False means 'Create a shot' will be refused.
created_attext
ISO 8601 timestamp of when the account joined Dribbble.
followers_countnumber
How many people follow the account.
html_urltext
Address of the profile page.
idnumber
Unique account id.
linksobject
The links shown on the profile.
locationtext
Location as written on the profile.
logintext
Username: the last part of the profile URL.
nametext
Display name.
protrue/false
Whether the account has a Dribbble Pro subscription.
teamslist
The teams this account belongs to.
typetext
'User' for a person, 'Team' for a team account.
Example output
{
  "avatar_url": "https://cdn.dribbble.com/users/1/avatars/normal/dc.jpg",
  "bio": "Co-founder & designer of @Dribbble.",
  "can_upload_shot": true,
  "created_at": "2009-07-08T02:51:22Z",
  "followers_count": 66557,
  "html_url": "https://dribbble.com/simplebits",
  "id": 1,
  "links": {
    "twitter": "https://twitter.com/simplebits",
    "web": "http://simplebits.com"
  },
  "location": "Salem, MA",
  "login": "simplebits",
  "name": "Dan Cederholm",
  "pro": true,
  "teams": [
    {
      "avatar_url": "https://cdn.dribbble.com/users/39/avatars/normal/logo.png",
      "bio": "Show and tell for designers.",
      "created_at": "2009-08-18T18:34:31Z",
      "html_url": "https://dribbble.com/dribbble",
      "id": 39,
      "links": {
        "web": "http://dribbble.com"
      },
      "location": "Salem, MA",
      "login": "dribbble",
      "name": "Dribbble",
      "type": "Team",
      "updated_at": "2014-02-14T22:32:11Z"
    }
  ],
  "type": "User"
}

List my projects

List the projects on the connected Dribbble account (the named groups a designer files shots under) with each project's id, name, description and shot count. Results are paged the same way shots are. This is how a workflow finds the id of a project to rename or delete.

Inputs

Pagepagenumber
Which page of results to read. Leave blank for the first page; the result's 'next_page' tells you what to ask for next.At least 1.
Results per pageper_pagenumber
How many records to return, from 1 to 100. Leave blank for Dribbble's default of 30.From 1 to 100.

Outputs

One page of projects.

countnumber
How many records this page holds.
has_moretrue/false
Whether Dribbble offered a next page.
next_pagenumber
The page number to ask for next, or null on the last page.
pagenumber
The page number that was read.
per_pagenumber
The page size that was asked for.
projectslist
The projects on this page.
Example output
{
  "count": 1,
  "has_more": false,
  "next_page": null,
  "page": 1,
  "per_page": 30,
  "projects": [
    {
      "created_at": "2011-04-14T03:43:47Z",
      "description": "Visual design and art direction for this project.",
      "id": 3,
      "name": "Web Standards Sherpa",
      "shots_count": 4,
      "updated_at": "2012-04-04T22:39:53Z"
    }
  ]
}

List my shots

List the shots on the connected Dribbble account, newest first, with each shot's id, title, description, tags, image addresses and publication date. Results are paged: the answer reports whether Dribbble offered another page and which page number to ask for next. This is how a workflow finds the id of a shot to read, update or delete.

Inputs

Pagepagenumber
Which page of results to read. Leave blank for the first page; the result's 'next_page' tells you what to ask for next.At least 1.
Results per pageper_pagenumber
How many records to return, from 1 to 100. Leave blank for Dribbble's default of 30.From 1 to 100.

Outputs

One page of shots.

countnumber
How many records this page holds.
has_moretrue/false
Whether Dribbble offered a next page.
next_pagenumber
The page number to ask for next, or null on the last page.
pagenumber
The page number that was read.
per_pagenumber
The page size that was asked for.
shotslist
The shots on this page.
Example output
{
  "count": 1,
  "has_more": false,
  "next_page": null,
  "page": 1,
  "per_page": 30,
  "shots": [
    {
      "animated": false,
      "description": "<p>Quick, messy, five minute sketch.</p>",
      "height": 300,
      "html_url": "https://dribbble.com/shots/471756-Sasquatch",
      "id": 471756,
      "images": {
        "hidpi": null,
        "normal": "https://cdn.dribbble.com/users/1/screenshots/471756/sasquatch.png",
        "teaser": "https://cdn.dribbble.com/users/1/screenshots/471756/sasquatch_teaser.png"
      },
      "low_profile": false,
      "published_at": "2012-03-15T01:52:33Z",
      "tags": [
        "fiction",
        "sasquatch",
        "sketch",
        "wip"
      ],
      "title": "Sasquatch",
      "updated_at": "2012-03-15T02:12:57Z",
      "width": 400
    }
  ]
}

Update a project

Rename a project on the connected Dribbble account, change its description, or both. Whichever field you leave blank is kept as it is.

Inputs

Projectproject_idtextRequired
Which of your projects to act on. The list holds this account's own projects; you can also paste a project id.
Namenametext
A new name. Leave blank to keep the current one.
Descriptiondescriptiontext
A new description. Leave blank to keep the current one.

Outputs

A Dribbble project: a named group of shots on a profile.

created_attext
ISO 8601 timestamp of when the project was created.
descriptiontext
The project's description.
idnumber
Unique project id.
nametext
The project's name.
shots_countnumber
How many shots are in the project.
updated_attext
ISO 8601 timestamp of the project's last change.
Example output
{
  "created_at": "2011-04-14T03:43:47Z",
  "description": "Visual design and art direction for this project.",
  "id": 3,
  "name": "Web Standards Sherpa",
  "shots_count": 4,
  "updated_at": "2012-04-04T22:39:53Z"
}

Update a shot

Change a shot you own: its title, description, tags, low profile setting, scheduled publication time, or the team it is published under. Fields left blank are kept as they are. The image itself cannot be replaced: Dribbble has no endpoint for that. Needs the 'upload' permission.

Inputs

Shotshot_idtextRequired
Which of your shots to act on. The list holds this account's own shots, newest first; you can also paste a shot id or the address of the shot's page.
Titletitletext
A new title. Leave blank to keep the current one.
Descriptiondescriptiontext
A new description. Leave blank to keep the current one. Basic HTML is allowed.
Tagstagslist
Tags describing the shot, used by Dribbble's search and browse pages. Up to 12; blanks and repeats are dropped.
Low profilelow_profiletrue/false
Keep the shot off your followers' feeds and Dribbble's browse pages. It stays on your profile and anyone with the link can still see it, which is what to use for a test post.
Publish atscheduled_fordate and time
Publish the shot at this date and time instead of straight away. Leave blank to publish immediately. Scheduling is a Dribbble Pro feature.
Teamteamtext
Publish the shot under one of your Dribbble teams instead of your own profile. Leave blank to post as yourself. The list holds the teams this account belongs to.

Outputs

A Dribbble shot.

animatedtrue/false
Whether the highest-resolution image is animated.
descriptiontext
The shot's description, as HTML.
heightnumber
Image height in pixels.
html_urltext
Address of the shot's page.
idnumber
Unique shot id.
imagesobject
The rendered image at each size Dribbble keeps.
low_profiletrue/false
Whether the shot is hidden from followers' feeds and browse pages.
published_attext
ISO 8601 timestamp of when the shot went live.
tagslist
The shot's tags.
titletext
The shot's title.
updated_attext
ISO 8601 timestamp of the shot's last change.
widthnumber
Image width in pixels.
Example output
{
  "animated": false,
  "description": "<p>Quick, messy, five minute sketch.</p>",
  "height": 300,
  "html_url": "https://dribbble.com/shots/471756-Sasquatch",
  "id": 471756,
  "images": {
    "hidpi": null,
    "normal": "https://cdn.dribbble.com/users/1/screenshots/471756/sasquatch.png",
    "teaser": "https://cdn.dribbble.com/users/1/screenshots/471756/sasquatch_teaser.png"
  },
  "low_profile": false,
  "published_at": "2012-03-15T01:52:33Z",
  "tags": [
    "fiction",
    "sasquatch",
    "sketch",
    "wip"
  ],
  "title": "Sasquatch",
  "updated_at": "2012-03-15T02:12:57Z",
  "width": 400
}

Dragon Ball API

Previous Page

Drip

Next Page

On this page

ActionsCreate a projectCreate a shotDelete a projectDelete a shotGet a shotGet my Dribbble accountList my projectsList my shotsUpdate a projectUpdate a shot