Documentation

v1.0.0

Getting started

First things first, you’ll need to request an API key so we can understand what you want to build and ensure we can make it happen.

Authorization

Authorization with 99designs requires the following HTTP headers are forwarded on every request: Api-Key-Id and Api-Key-Secret. The values for theses headers are provided by 99designs.

curl -H "Api-Key-Id:xxx" -H "Api-Key-Secret:xxx" https://api.99designs.com/resources/v1/designers

Briefs

The following API calls are for unauthenticated users and therefore will require that the end user come to 99designs to create an account (or log into an existing one). Each will provide a response with the appropriate URL to allow the end user to do so.

Create a brief

Example request:
curl -X POST https://api.99designs.com/resources/v1/briefs -H "Content-Type:application/json" -d '{
  "category": "product-packaging",
  "title": "Packaging for The Organic Juicy Fruits Company",
  "description": "I need a package designed for a new flavor of organic juice.",
  "profileApproval": false,
  "industry": "accounting",
  "inspirationUrls": [
    "https://example.org/example1",
    "https://example.org/example2"
  ],
  "budget": {
    "value": 10000,
    "currency": "USD"
  },
  "other": "",
  "timeframe": {
    "value": "specific_dates",
    "startDate": "2018-01-20T00:00:00+0500",
    "endDate": "2018-01-20T00:00:00+0500"
  },
  "urls": [
    ""
  ],
  "usage": "Billboards, flyers, and magazines",
  "language": "de"
}'
Body parameters:
category
string

What type of design do you need?

e.g. product-packaging

Values3d-designalbum-cover-designapp-designart-illustrationbanner-ad-designbook-cover-designbook-magazine-designbrand-guidebrand-identity-packbrochure-designbusiness-advertisingbusiness-card-designbuttons-iconscar-truck-van-wrap-designcard-invitation-designcharacter-mascot-designclothing-apparel-designclothing-merchandise-designcup-mug-designcustom-wordpress-themesemail-designfacebook-adfacebook-cover-designflash-animationflash-banner-designicon-button-designillustrationsinfographic-designlanding-page-designlogologo-brand-guidelogo-business-card-designlogo-designlogo-product-packaginglogo-websitemagazine-cover-designmenu-designmerchandise-designmobile-app-designnationbuilderotherother-art-illustrationother-book-magazine-designother-business-advertisingother-clothing-merchandise-designother-designother-design-tasksother-packaging-label-designother-website-app-designpackaging-label-designpodcast-cover-designpostcard-flyer-designposter-designpowerpoint-template-designprezi-designprint-designproduct-label-designproduct-packaging-designquickbooks-form-designsignage-designsocial-media-packsocial-media-page-designsquare-online-storesquarespacestationery-designsticker-designt-shirt-designtattoo-designtwitter-background-designtypesettingtypesetting-with-imageryweb-builderweb-designweb-design-codedwebsite-app-designwix-websitewordpress-theme-designzoom-background-design
title
string

What's the name of your project?

e.g. Packaging for The Organic Juicy Fruits Company

description
string

Describe your project

e.g. I need a package designed for a new flavor of organic juice.

profileApproval
boolean

Can your designer showcase the finished designs in their 99designs portfolio?

industry
string

What industry are you in?

Valuesaccountingagricultureanimalsarchitecturalartattorneyautomotivebarbusinesschildrencleaningcommunicationscommunitycomputerconstructioncosmeticsdatingeducationentertainmentenvironmentfashionfloralfoodgameshomeindustrialinternetlandscapingmedicalotherphotographyphysicalpoliticsrealestatereligiousrestaurantretailsecurityspasportstechnologytravelwedding
inspirationUrls
array

Inspiration on the web

e.g.[ "https://example.org/example1", "https://example.org/example2" ]
budget
object

Client budget

value
integer

budget in cents

e.g. 10000

currency
string

e.g. USD

other
string

Anything else you'd like to share with your designer?

timeframe
object

Project timeframe

value
string

e.g. specific_dates

Valuesforty_eight_hoursone_weektwo_weeksone_monthspecific_datesnot_sure
startDate
string

ISO 8601 (YYYY-MM-DDTHH:mm:ssZ)

e.g. 2018-01-20T00:00:00+0500

endDate
string

ISO 8601 (YYYY-MM-DDTHH:mm:ssZ)

e.g. 2018-01-20T00:00:00+0500

urls
array

Your website and/or social media pages

usage
string

How will your design be used?

e.g. Billboards, flyers, and magazines

language
string
Valuesdeenesfritjanlpt
Example response(s):
201Created brief
{
  "id": "abc123",
  "briefUrl": "99designs.com/briefs/abc123"
}
400Validation error(s)
{
  "errors": [
    {
      "path": "/briefs",
      "message": "Invalid timeframe"
    }
  ]
}