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”).
link_to_apply string Required An absolute URL to the application form of the job listing.
description string Required The full html description of the job (allowed tags: a ol ul li h1 h2 h3 p strong em br).
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
category string The category of the job.
One of: Graphic Designer, UI/UX Designer, Mobile Designer, Web Designer, Product Designer, Creative Director, Art Director, Interaction Designer, Motion Designer, Illustrator, Animator, Brand Designer, Mobile Developer, Front-end Developer, Other

Default: null
role_type string The type of role of the job.
One of: full-time, part-time, freelance, contract

Default: null
website string An absolute url to the company’s website.

Default: null
twitter string An absolute url to the company’s twitter page.

Default: null
instagram string An absolute url to the company’s instagram page.

Default: null
facebook string An absolute url to the company’s facebook page.

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" : "https://dribbble.com/jobs/999999",
  "link_to_apply" : "http://example.com/job-listing",
  "description" : "<h1>Example Job</h1><p>This job requires many skills...</p>",
  "category" : "Graphic Designer",
  "role_type" : "full-time",
  "website" : "https://example.com",
  "twitter" : "https://twitter.com/example",
  "instagram" : "https://instagram.com/example",
  "facebook" : "https://facebook.com/example",
  "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",
    "login" : "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"
    },
    "type" : "Team",
    "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”)
link_to_apply string Required An absolute URL to the application form of the job listing.
description string Required The full html description of the job (allowed tags: a ol ul li h1 h2 h3 p strong em br).
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
category string The category of the job.
One of: Graphic Designer, UI/UX Designer, Mobile Designer, Web Designer, Product Designer, Creative Director, Art Director, Interaction Designer, Motion Designer, Illustrator, Animator, Brand Designer, Mobile Developer, Front-end Developer, Other

Default: null
role_type string The type of role of the job.
One of: full-time, part-time, freelance, contract

Default: null
website string An absolute url to the company’s website.

Default: null
twitter string An absolute url to the company’s twitter page.

Default: null
instagram string An absolute url to the company’s instagram page.

Default: null
facebook string An absolute url to the company’s facebook page.

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" : "https://dribbble.com/jobs/999999",
  "link_to_apply" : "http://example.com/job-listing",
  "description" : "<h1>Example Job</h1><p>This job requires many skills...</p>",
  "category" : "Graphic Designer",
  "role_type" : "full-time",
  "website" : null,
  "twitter" : null,
  "instagram" : null,
  "facebook" : null,
  "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" : "https://dribbble.com/jobs/999999",
  "link_to_apply" : "http://example.com/job-listing",
  "description" : "<h1>Example Job</h1><p>This job requires many skills...</p>",
  "category" : "Graphic Designer",
  "role_type" : "full-time",
  "website" : null,
  "twitter" : null,
  "instagram" : null,
  "facebook" : null,
  "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
}