Quickstart - Taptalent Partner API

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

Log in to your Taptalent Dashboard
Navigate to Account Settings > Developers > API Key Management
Click Generate API Key
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": 12345,
  "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": "pipelineId_1",
  "companyId": "companyId_1",
  "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/12345" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Common Failure Reasons

If your request fails, check for these common issues:

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
403 Forbidden: Your subscription is inactive
- Ensure your TapTalent subscription is active
- Contact support if the issue persists
400 Bad Request: Invalid request data
- Verify all required fields are present
- Check field validation rules (e.g., title must be 3-120 characters)
- Ensure data types match the expected format

Next Steps

Explore the Jobs API Reference for detailed endpoint documentation
Set up Webhooks to receive real-time updates
Review Integration Notes for best practices

​Prerequisites

​Step 1: Get Your API Key

​Step 2: Make Your First Request

​Step 3: Understand the Response

​Step 4: Retrieve Your Job

​Common Failure Reasons

​Next Steps

Prerequisites

Step 1: Get Your API Key

Step 2: Make Your First Request

Step 3: Understand the Response

Step 4: Retrieve Your Job

Common Failure Reasons

Next Steps