Skip to main content
POST
/
api
/
v1
/
custom-fields
Create Custom Field
curl --request POST \
  --url https://api.bindbee.dev/api/v1/custom-fields \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "name": "<string>",
  "category": "HRIS",
  "model": "<string>",
  "description": "Employee's guardian mobile number"
}
EOF
{}

Documentation Index

Fetch the complete documentation index at: https://docs.bindbee.dev/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
name
string
required

Name of the custom field. Must be snake_case.

Required string length: 2 - 128
Example:

"guardian_mobile"

​
category
enum<string>
required

Category of the model on which the custom field is created.

Available options:
HRIS,
ATS,
LMS
Example:

"HRIS"

​
model
string
required

Model on which the custom field is to be applied.

Maximum string length: 64
Pattern: ^[a-z][a-z0-9_-]*$
Example:

"employee"

​
description
string | null

Description of the custom field.

Example:

"Employee's guardian mobile number"

Response

Successful Response

The response is of type Response Create Custom Field Api V1 Custom Fields Post · object.