Create or update a Scheduling Link via OAuth | Close

curl -X POST https://api.close.com/api/v1/scheduling_link/integration/ \
     -H "Content-Type: application/json" \
     -u "<CLOSE_API_KEY>:" \
     -d '{
  "description": "Let\'s find a time to meet!",
  "duration_in_minutes": 60,
  "name": "Chat with Us",
  "source_id": "74241bb7-3436-4228-9b76-392ef7a443ee",
  "source_type": "Multi-Use",
  "url": "https://your-app.example.com/link/example/"
}'

{
  "description": "Let's find a time to meet!",
  "duration_in_minutes": 60,
  "id": "schlnk_2xfNHpU6cjThMuhioZ3GjX",
  "name": "Chat with Us",
  "oauth_client_id": "oa2client_5NvOjgHYKHkbBjv5Rmiyfp",
  "organization_id": "orga_RbREgmiiwcr1w2b4cOnCMQaQPSIFxMqAD2Dh243uxcH",
  "source": "THIRD_PARTY",
  "source_id": "74241bb7-3436-4228-9b76-392ef7a443ee",
  "source_type": "Multi-Use",
  "type": "USER",
  "url": "https://your-app.example.com/link/example/",
  "user_id": "user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA"
}

Please note that only OAuth apps can perform this operation. Using API key will result in an error. See Authentication with OAuth for more information.

Create or update a user scheduling link, managed by your application. Uses the integration-provided source_id field to identify and merge duplicate resources created by the same OAuth Application. If a scheduling link created by your OAuth application with the specified source_id does not exist, a new one will be created. Otherwise, the scheduling link resource will be updated. Requires authentication via OAuth.

Please note that only OAuth apps can perform this operation. Using API key will result in an error. See [Authentication with OAuth](/topics/authentication-oauth2/) for more information. Create or update a user scheduling link, managed by your application. Uses the integration-provided `source_id` field to identify and merge duplicate resources created by the same OAuth Application. If a scheduling link created by your OAuth application with the specified `source_id` does not exist, a new one will be created. Otherwise, the scheduling link resource will be updated. Requires authentication via OAuth.

Authentication

AuthorizationBasic

Basic authentication of the form Basic <base64(username:)>.

AuthorizationBearer

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

Request

This endpoint expects any.

Response

Successful response

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error