Skip to main content
POST
Bulk create or update custom field values

Authorizations

Authorization
string
header
required

Company-scoped API key. Production keys are prefixed sk_live_, sandbox keys sk_test_, each followed by 22 base62 characters (pattern ^sk_(live|test)_[0-9A-Za-z]{22}$). Generate keys in the TapTalent dashboard under Account Settings → Developers → API Key Management; a key is shown once at generation and old keys are invalidated immediately on regeneration.

Body

application/json

Request body for creating or updating multiple custom field values for one candidate or job in a single request.

entityType
enum<string>
required

The entity a custom field applies to.

Available options:
candidate,
job
entityId
integer
required

The ID of the candidate or job.

Example:

12345

values
object[]
required

Array of value objects with customFieldId, value, and optional parentEntityType/parentEntityId.

Response

The created or updated custom field values. The source documentation does not include a response example for this endpoint; see the schema's inference note.

Envelope returned after bulk creating or updating custom field values. Response schema inferred from related endpoints; not yet verified against production behavior.

status
enum<string>
required

Always success for successful requests.

Available options:
success
data
object[]
required