Skip to content

Update a subscription

PUT https://api.copper.com/developer_api/v1/webhooks/{{subscription_id}}

Parameters

Note that all 3 parameters listed below can be optionally provided.

Field Type Details
target string The URL of your webhook endpoint.
secret JSON JSON containing custom key/value pairs that are sent as-is with every notification. Using this secret, your notification endpoint can authenticate the request to make sure it is coming from a trusted source.
custom_field_computed_values boolean If provided and set to true, dropdown custom fields (standard and multi-select) will have their option_ids converted to the option names.

See the Webhook properties section for more details.

Request body

1
2
3
4
5
6
7
8
{
  "target": "https://your.endpoint.here",
  "secret": {
    "secret": "hook_source",
    "key": "copper_notifications"
  },
  "custom_field_computed_values": true
}

Example Requests

Update a subscription

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
curl --location --request PUT "https://api.copper.com/developer_api/v1/webhooks/{subscription_id}" \
  --header "X-PW-AccessToken: YOUR_TOKEN_HERE" \
  --header "X-PW-Application: developer_api" \
  --header "X-PW-UserEmail: YOUR_EMAIL_HERE" \
  --header "Content-Type: application/json" \
  --data "{
  \"target\": \"https://your.endpoint.here\",
  \"secret\": {
    \"secret\": \"hook_source\",
    \"key\": \"copper_notifications\"
  },
  \"custom_field_computed_values\": true,
}"
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
{
  "id": 17065,
  "target": "https://your.endpoint.here",
  "type": "lead",
  "event": "update",
  "secret": {
    "secret": "hook_source",
    "key": "copper_notifications"
  },
 "custom_field_computed_values": true,
  "created_at": 1489173015
}