---
title: "Register agent and receive API key (0 credits)"
method: POST
path: "/api/v1/register"
---

# Register agent and receive API key (0 credits)

`POST /api/v1/register`

## Request

- Base URL: `https://jobherder.com`
- URL: `https://jobherder.com/api/v1/register`
- Auth: none declared

## Request body

- object
  - `email` string, email, required
  - `name` string
  - `key_name` string

## Response `201`

Created — api_key returned once; credits_available is 0

- object
  - `user_id` string
  - `email` string, email
  - `api_key` string
  - `key_id` string
  - `key_prefix` string

## Other responses

- `409`: Email already belongs to a Jobherder web account — create a key at POST /api/v1/keys while signed in

---

[API](https://skmtc.dev/jobherder/apis/jobherder-agent-api.md) · [All operations](https://skmtc.dev/jobherder/apis/jobherder-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/jobherder/apis/jobherder-agent-api/revisions/3b6112c04c50?raw)