API Changelog

We now publish an OpenAPI spec for the Close API at: https://api.close.com/api/openapi.json

This spec is currently considered experimental and does not yet contain 100% coverage of request/response schemas. If you have any feedback or use cases you’d like to share, please let us know by emailing support@close.com.

The applies_to field on the Outcome API is now deprecated on write operations (create and update). In a future update, the field will be ignored on create and update requests and will instead be derived from the type field:

• When type is custom, applies_to will always be ["calls", "meetings"].
• When type is vm-dropped, applies_to will be ["calls"].

The applies_to field will continue to be returned in read responses. No changes are needed for integrations that only read this field.

We have added support for Form Submissions as a new activity type. Form Submissions are created by the system whenever someone fills out a Close Form.

We also introduced new events activity.form_submission.created, activity.form_submission.updated, and activity.form_submission.deleted, which you can subscribe to using webhooks.

We fixed a bug in the Email API that previously allowed creating emails without a sender in cases where a sender is required.

The sender field is required for emails with status inbox, scheduled, outbox, or error. It may be omitted in the following cases:

• For draft, since the sender can be specified later before sending.
• For sent, where it defaults to the email address of the user associated with the email or the owner of the API key.

When updating a draft’s status to scheduled or outbox, the sender field is now required if the email doesn’t have one yet.

You can now set a Note’s title field when creating or updating a Note via the Note API.

We have also added the title and pinned_at fields to responses in the Note API.

We have introduced the Outcome API which allows you to organize & manage outcomes, i.e. standardized results that can be applied to activities such as calls and meetings.

Outcomes can help sales teams track and categorize the results of their interactions with prospects and customers.