Skip to main content

​
Quickstart Guide

This guide will walk you through making your first API call to the Taptalent Partner API by creating a job posting.

​
Prerequisites

  • A Taptalent account with an active subscription
  • An API key (see API Keys for instructions)

​
Step 1: Get Your API Key

  1. Log in to your Taptalent Dashboard
  2. Navigate to Account Settings > Developers > API Key Management
  3. Click Generate API Key
  4. Copy the API key immediately - it won’t be shown again
Never share your API key publicly or commit it to version control. Treat it like a password. The API key format is sk_live_... for production or sk_test_... for testing.

​
Step 2: Make Your First Request

Let’s create a job posting. Use the following curl command: 
curl -X POST "https://partner-api.taptalent.io/v1/partner/jobs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Senior Software Engineer",
    "description": "We are looking for an experienced software engineer...",
    "city": "San Francisco",
    "state": "California",
    "country": "United States",
    "workMode": "REMOTE",
    "status": "DRAFT"
  }'
Replace YOUR_API_KEY with your actual API key.

​
Step 3: Understand the Response

You should receive a JSON response like this: 
{
  "id": "job-uuid-here",
  "title": "Senior Software Engineer",
  "description": "We are looking for an experienced software engineer...",
  "city": "San Francisco",
  "state": "California",
  "country": "United States",
  "workMode": "REMOTE",
  "status": "DRAFT",
  "pipelineId": "pipeline-uuid",
  "companyId": "company-uuid",
  "createdAt": 1234567890
}

​
Step 4: Retrieve Your Job

Now let’s retrieve the job you just created: 
curl -X GET "https://partner-api.taptalent.io/v1/partner/jobs/job-uuid-here" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

​
Common Failure Reasons

If your request fails, check for these common issues:
  1. 401 Unauthorized: Your API key is missing or invalid
    • Verify the API key is correct
    • Ensure you’re using the Bearer token format
    • Check that your API key is active
  2. 403 Forbidden: Your subscription is inactive
    • Ensure your TapTalent subscription is active
    • Contact support if the issue persists
  3. 400 Bad Request: Invalid request data
    • Verify all required fields are present
    • Check field validation rules (e.g., title must be 3-500 characters)
    • Ensure data types match the expected format

​
Next Steps