# Popp Candidates API

**Canonical:** https://apis.io/apis/popp/popp-candidates-api/  
**Provider:** Popp — https://apis.io/providers/popp/  
**Base URL:** https://api.joinpopp.com/v1  
**Documentation:** https://joinpopp.com/api

Popp Candidates API is one of 18 APIs that [Popp](https://apis.io/providers/popp/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Candidates. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, and 6 JSON Schemas.

The Candidates API from Popp — 12 operation(s) for candidates.

## Operations (19)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/candidates` | Create a candidate |
| DELETE | `/v1/candidates/by-email/{email}` | Delete candidates by email |
| PATCH | `/v1/candidates/by-external-id/{externalId}` | Update a candidate by external ID |
| GET | `/v1/candidates/by-external-id/{externalId}` | Get a candidate by external ID |
| DELETE | `/v1/candidates/by-external-id/{externalId}` | Delete a candidate by external ID |
| DELETE | `/v1/candidates/by-external-id/{externalId}/document` | Remove a candidate CV by external ID |
| GET | `/v1/candidates/by-external-id/{externalId}/notes` | List a candidate's notes by external ID |
| POST | `/v1/candidates/by-external-id/{externalId}/notes` | Add a note to a candidate by external ID |
| POST | `/v1/candidates/by-external-id/{externalId}/reparse` | Re-parse a candidate CV by external ID |
| DELETE | `/v1/candidates/by-phone-number/{phoneNumber}` | Delete candidates by phone number |
| PATCH | `/v1/candidates/{id}` | Update a candidate |
| GET | `/v1/candidates/{id}` | Get a candidate |
| DELETE | `/v1/candidates/{id}` | Delete a candidate |
| DELETE | `/v1/candidates/{id}/document` | Remove a candidate CV |
| GET | `/v1/candidates/{id}/notes` | List a candidate's notes |
| POST | `/v1/candidates/{id}/notes` | Add a note to a candidate |
| PATCH | `/v1/candidates/{id}/notes/{noteId}` | Update a candidate note |
| DELETE | `/v1/candidates/{id}/notes/{noteId}` | Delete a candidate note |
| POST | `/v1/candidates/{id}/reparse` | Re-parse a candidate CV |

## Machine-readable artifacts (17)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/popp/refs/heads/main/openapi/popp-candidates-api-openapi.yml
- **Documentation** — https://docs.joinpopp.com/
- **APIReference** — https://docs.joinpopp.com/docs/quickstart
- **GettingStarted** — https://docs.joinpopp.com/docs/quickstart
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/popp/refs/heads/main/authentication/popp-authentication.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/popp/refs/heads/main/asyncapi/popp-webhooks.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/popp/refs/heads/main/conventions/popp-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/popp/refs/heads/main/errors/popp-problem-types.yml
- **Lifecycle** — https://raw.githubusercontent.com/api-evangelist/popp/refs/heads/main/lifecycle/popp-lifecycle.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/popp/refs/heads/main/data-model/popp-data-model.yml
- **Conformance** — https://raw.githubusercontent.com/api-evangelist/popp/refs/heads/main/conformance/popp-conformance.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/popp/refs/heads/main/json-schema/popp-update-meeting-template-input-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/popp/refs/heads/main/json-schema/popp-create-meeting-template-input-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/popp/refs/heads/main/json-schema/popp-create-scheduling-conversation-input-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/popp/refs/heads/main/json-schema/popp-create-campaign-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/popp/refs/heads/main/json-schema/popp-list-campaigns-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/popp/refs/heads/main/json-schema/popp-list-ats-jobs-response-schema.json

## Other Popp APIs (12)

- [Popp Agents API](https://apis.io/apis/popp/popp-agents-api/)
- [Popp Analysis API](https://apis.io/apis/popp/popp-analysis-api/)
- [Popp ATS API](https://apis.io/apis/popp/popp-ats-api/)
- [Popp Campaigns API](https://apis.io/apis/popp/popp-campaigns-api/)
- [Popp Candidate Lists API](https://apis.io/apis/popp/popp-candidate-lists-api/)
- [Popp Conversations API](https://apis.io/apis/popp/popp-conversations-api/)
- [Popp Custom Fields (Beta) API](https://apis.io/apis/popp/popp-custom-fields-beta-api/)
- [Popp Document Credentials API](https://apis.io/apis/popp/popp-document-credentials-api/)
- [Popp Documents API](https://apis.io/apis/popp/popp-documents-api/)
- [Popp Organization Configuration API](https://apis.io/apis/popp/popp-organization-configuration-api/)
- [Popp Organizations API](https://apis.io/apis/popp/popp-organizations-api/)
- [Popp Scheduling API](https://apis.io/apis/popp/popp-scheduling-api/)

## Tags

Candidates

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/popp/popp-candidates-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/popp/.