Create an outcome | Close | Developer API Documentation

Create a new outcome for the organization.

Authentication

AuthorizationBasic

Use your API key as the username and leave the password empty.

AuthorizationBearer

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

Request

This endpoint expects an object.

namestringRequired

Displayed to users wherever outcomes can be selected.

descriptionstring or nullOptional

Explain what the outcome means and when it should be used.

typeenumOptional

Set to vm-dropped if this outcome should be automatically set on calls whenever a team member performs a Voicemail Drop. Otherwise, leave empty or explicitly set to custom (default).

Allowed values:

applies_tolist of enums or nullOptionalDeprecated

Deprecated. This field will be derived from type in a future update: custom applies to calls and meetings, vm-dropped applies to calls only.

Allowed values:

Response

Successful response

applies_tolist of enums

Allowed values:

created_bystring or null

date_createddatetime

date_updateddatetime

descriptionstring or null

idstring

namestring

organization_idstring

typeenum

Allowed values:

updated_bystring or null

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

Use your API key as the username and leave the password empty.

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

This endpoint expects an object.

Displayed to users wherever outcomes can be selected.

Explain what the outcome means and when it should be used.

Set to vm-dropped if this outcome should be automatically set on calls whenever a team member performs a Voicemail Drop. Otherwise, leave empty or explicitly set to custom (default).

Deprecated. This field will be derived from type in a future update: custom applies to calls and meetings, vm-dropped applies to calls only.

$	curl -X POST https://api.close.com/api/v1/outcome/ \
>	-H "Content-Type: application/json" \
>	-u "<CLOSE_API_KEY>:" \
>	-d '{
>	"name": "Not Interested",
>	"description": "Prospect declined our offer",
>	"type": "custom"
>	}'

1	{
2	"applies_to": [
3	"calls",
4	"meetings"
5	],
6	"created_by": "user_a6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
7	"date_created": "2025-07-29T10:30:00.000000+00:00",
8	"date_updated": "2025-07-29T10:30:00.000000+00:00",
9	"description": "Prospect declined our offer",
10	"id": "outcome_03oUxZfoO6e2vHmcz1DiHR",
11	"name": "Not Interested",
12	"organization_id": "orga_rbREgmiiwcr1w2b4cOnCMQaQPSIFxMqAD2Dh243uxcH",
13	"type": "custom",
14	"updated_by": "user_a6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA"
15	}

$	curl -X POST https://api.close.com/api/v1/outcome/ \
>	-H "Content-Type: application/json" \
>	-u "<CLOSE_API_KEY>:" \
>	-d '{
>	"name": "Not Interested",
>	"description": "Prospect declined our offer",
>	"type": "custom"
>	}'

1	{
2	"applies_to": [
3	"calls",
4	"meetings"
5	],
6	"created_by": "user_a6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
7	"date_created": "2025-07-29T10:30:00.000000+00:00",
8	"date_updated": "2025-07-29T10:30:00.000000+00:00",
9	"description": "Prospect declined our offer",
10	"id": "outcome_03oUxZfoO6e2vHmcz1DiHR",
11	"name": "Not Interested",
12	"organization_id": "orga_rbREgmiiwcr1w2b4cOnCMQaQPSIFxMqAD2Dh243uxcH",
13	"type": "custom",
14	"updated_by": "user_a6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA"
15	}