Developer

Jobs

How to Post Jobs on Dribbble

The /jobs endpoint allows you to post jobs to the Dribbble Jobs page. You can learn more about pricing and other details for posting jobs on our Jobs info page.

Before using this API endpoint, you need a special token. Please contact us if you would like to partner with Dribbble and post jobs via our API.

Create a job

POST /jobs

Parameters

Name Type Description
organization_name string Required The name of the organization the position is with.
title string Required The title of the job position.
location string Required The physical location of the position (e.g. “Boston” or “Anywhere”).
url string Required An absolute URL to the full details of the job listing.
active boolean true if you want the job to be published immediately.

Default: false
team string or integer The integer id or string login of the team that you want associated with the job.

Default: null

For testing, we recommend submitting inactive jobs and verifying the results in your jobs dashboard on Dribbble. From there, you can manually edit and activate jobs.

Response

Status: 201 Created
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
{
  "id" : 10262,
  "organization_name" : "Example Company",
  "title" : "Senior Designer",
  "location" : "San Francisco",
  "url" : "http://example.com/job-listing",
  "created_at" : "2016-01-11T17:20:15Z",
  "updated_at" : "2016-01-11T17:20:15Z",
  "active" : false,
  "starts_at" : null,
  "ends_at" : null,
  "team" : {
    "id" : 39,
    "name" : "Dribbble",
    "username" : "dribbble",
    "html_url" : "https://dribbble.com/dribbble",
    "avatar_url" : "https://d13yacurqjgara.cloudfront.net/users/39/avatars/normal/apple-flat-precomposed.png?1388527574",
    "bio" : "Show and tell for designers. This is Dribbble on Dribbble.",
    "location" : "Salem, MA",
    "links" : {
      "web" : "http://dribbble.com",
      "twitter" : "https://twitter.com/dribbble"
    },
    "buckets_count" : 1,
    "comments_received_count" : 2037,
    "followers_count" : 25011,
    "followings_count" : 6120,
    "likes_count" : 44,
    "likes_received_count" : 15811,
    "members_count" : 7,
    "projects_count" : 4,
    "rebounds_received_count" : 416,
    "shots_count" : 91,
    "can_upload_shot" : true,
    "type" : "Team",
    "pro" : false,
    "buckets_url" : "https://dribbble.com/v1/users/39/buckets",
    "followers_url" : "https://dribbble.com/v1/users/39/followers",
    "following_url" : "https://dribbble.com/v1/users/39/following",
    "likes_url" : "https://dribbble.com/v1/users/39/likes",
    "members_url" : "https://dribbble.com/v1/teams/39/members",
    "shots_url" : "https://dribbble.com/v1/users/39/shots",
    "team_shots_url" : "https://dribbble.com/v1/users/39/teams",
    "created_at" : "2009-08-18T18:34:31Z",
    "updated_at" : "2014-02-14T22:32:11Z"
  }
}

Update a job

PUT /jobs/:id

Parameters

Name Type Description
organization_name string The name of the organization the position is with.
title string The title of the job position.
location string The physical location of the position (e.g. “Boston” or “Anywhere”)
url string An absolute URL to the full details of the job listing.
active boolean true if you want the job to be published immediately
team string or integer The integer id or string login of the team that you want associated with the job.

Default: null

Response

Status: 200 OK
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
{
  "id" : 10262,
  "organization_name" : "Example Company",
  "title" : "Senior UX Designer",
  "location" : "Anywhere",
  "url" : "http://example.com/job-listing",
  "created_at" : "2016-01-11T17:20:15Z",
  "updated_at" : "2016-01-11T18:23:31Z",
  "active" : true,
  "starts_at" : "2016-01-11T18:23:31Z",
  "ends_at" : "2016-02-10T18:23:31Z",
  "team" : null
}

Show a job

GET /jobs/:id
Status: 200 OK
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
{
  "id" : 10262,
  "organization_name" : "Example Company",
  "title" : "Senior UX Designer",
  "location" : "Anywhere",
  "url" : "http://example.com/job-listing",
  "created_at" : "2016-01-11T17:20:15Z",
  "updated_at" : "2016-01-11T18:23:31Z",
  "active" : true,
  "starts_at" : "2016-01-11T18:23:31Z",
  "ends_at" : "2016-02-10T18:23:31Z",
  "team" : null
}