> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taptalent.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Get started with the Taptalent Partner API in minutes

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](/authentication/api-keys) for instructions)

## Step 1: Get Your API Key

1. Log in to your [Taptalent Dashboard](https://client.taptalent.io/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

<Warning>
  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.
</Warning>

## Step 2: Make Your First Request

Let's create a job posting. Use the following curl command:

```bash theme={null}
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:

```json theme={null}
{
  "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:

```bash theme={null}
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:

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-120 characters)
   * Ensure data types match the expected format

## Next Steps

* Explore the [Jobs API Reference](/api-reference/jobs) for detailed endpoint documentation
* Set up [Webhooks](/webhooks/overview) to receive real-time updates
* Review [Integration Notes](/integration-notes/overview) for best practices