{
"opencollection": "1.0.0",
"info": {
"name": "Pipedrive API v1 Activities OrganizationFields API",
"version": "1.0.0"
},
"items": [
{
"info": {
"name": "OrganizationFields",
"type": "folder"
},
"items": [
{
"info": {
"name": "Get all organization fields",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.pipedrive.com/v1/organizationFields",
"params": [
{
"name": "start",
"value": "",
"type": "query",
"description": "Pagination start"
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Items shown per page"
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Returns data about all organization fields."
},
{
"info": {
"name": "Add a new organization field",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.pipedrive.com/v1/organizationFields",
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Adds a new organization field. For more information, see the tutorial for adding a new custom field."
},
{
"info": {
"name": "Delete multiple organization fields in bulk",
"type": "http"
},
"http": {
"method": "DELETE",
"url": "https://api.pipedrive.com/v1/organizationFields",
"params": [
{
"name": "ids",
"value": "",
"type": "query",
"description": "The comma-separated field IDs to delete"
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Marks multiple fields as deleted."
},
{
"info": {
"name": "Get one organization field",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.pipedrive.com/v1/organizationFields/:id",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the field"
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Returns data about a specific organization field."
},
{
"info": {
"name": "Update an organization field",
"type": "http"
},
"http": {
"method": "PUT",
"url": "https://api.pipedrive.com/v1/organizationFields/:id",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the field"
}
],
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Updates an organization field. For more information, see the tutorial for updating custom fields' values."
},
{
"info": {
"name": "Delete an organization field",
"type": "http"
},
"http": {
"method": "DELETE",
"url": "https://api.pipedrive.com/v1/organizationFields/:id",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the field"
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Marks a field as deleted. For more information, see the tutorial for deleting a custom field."
},
{
"info": {
"name": "Get one organization field",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.pipedrive.com/v1/organizationFields/:field_code",
"params": [
{
"name": "field_code",
"value": "",
"type": "path",
"description": "The unique code identifying the field"
},
{
"name": "include_fields",
"value": "",
"type": "query",
"description": "Optional comma separated string array of additional data namespaces to include in response"
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Returns metadata about a specific organization field."
},
{
"info": {
"name": "Update one organization field",
"type": "http"
},
"http": {
"method": "PATCH",
"url": "https://api.pipedrive.com/v1/organizationFields/:field_code",
"params": [
{
"name": "field_code",
"value": "",
"type": "path",
"description": "The unique code identifying the field"
}
],
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Updates an organization custom field. The field_code and field_type cannot be changed. At least one field must be provided in the request body."
},
{
"info": {
"name": "Delete one organization field",
"type": "http"
},
"http": {
"method": "DELETE",
"url": "https://api.pipedrive.com/v1/organizationFields/:field_code",
"params": [
{
"name": "field_code",
"value": "",
"type": "path",
"description": "The unique code identifying the field"
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Marks a custom field as deleted."
},
{
"info": {
"name": "Add organization field options in bulk",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.pipedrive.com/v1/organizationFields/:field_code/options",
"params": [
{
"name": "field_code",
"value": "",
"type": "path",
"description": "The unique code identifying the field"
}
],
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Adds new options to an organization custom field that supports options (enum or set field types). This operation is atomic - all options are added or none are added. Returns only the newly added options."
},
{
"info": {
"name": "Update organization field options in bulk",
"type": "http"
},
"http": {
"method": "PATCH",
"url": "https://api.pipedrive.com/v1/organizationFields/:field_code/options",
"params": [
{
"name": "field_code",
"value": "",
"type": "path",
"description": "The unique code identifying the field"
}
],
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Updates existing options for an organization custom field. This operation is atomic and fails if any of the specified option IDs do not exist. Returns only the updated options."
},
{
"info": {
"name": "Delete organization field options in bulk",
"type": "http"
},
"http": {
"method": "DELETE",
"url": "https://api.pipedrive.com/v1/organizationFields/:field_code/options",
"params": [
{
"name": "field_code",
"value": "",
"type": "path",
"description": "The unique code identifying the field"
}
],
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Removes existing options from an organization custom field. This operation is atomic and fails if any of the specified option IDs do not exist. Returns only the deleted options."
}
]
}
],
"bundled": true
}