Subscription Management

endpoints and functionality use subscription management endpoints to see all available (webhook) subscriptions and related information see detailed information about your (webhook) subscriptions renew your subscriptions delete your subscriptions 📌 by subscriptions, we refer to webhook update subscriptions made in experience changes endpoints you will only be able to see the subscriptions connected to your token see the endpoints and their functions below endpoint function /v2/subscriptions see all your subscriptions, their status, creation, and expiration dates /v2/ subscriptions/{subsription id} see all your subscriptions, their status, used filters or es dsl schema, creation, expiration dates, and last webhook date delete /v2/subscriptions/{subscription id} delete your subscriptions i want to see all my active subscriptions use the endpoint /v2/subscriptions to see all your available subscriptions, their statuses, creation and expiration dates indicate if you want to see the details of active or expired subscriptions ( expired = false or expired = true ) you will automatically see only active subscriptions if you omit the expired = true/false parameter indicate which page number you wish to see each page contains about 1000 subscriptions, so if you have more than 1000 subscriptions, you might need to indicate the page number replace {api key} with your api key in the template below request template curl x 'get' \\ 'https //api coresignal com/cdapi/v2/subscriptions?expired={false/true}\&page={integer}' \\ h 'accept application/json' \\ h 'apikey {api key}' request example curl x 'get' \\ 'https //api coresignal com/cdapi/v/subscriptions?expired=false\&page=1' \\ h 'accept application/json' \\ h 'apikey {api key}' 4\ send the request 5\ refer to the body for information about your subscription status \[ { "id" "c8e295c0 2f85 473d 8bef 350526e6b30a", "status" "active", "created at" "2024 09 18", "expiring at" "2024 12 18" }, { "id" "a85b2528 6190 4c91 8489 364b27ccbf81", "status" "active", "created at" "2024 09 18", "expiring at" "2024 12 18" } ] data point description data type id subscription identification key subscription id is displayed in the response body after submitting a webhook subscription via member experience endpoints string status subscription status (active or expired) string created at subscription start date in yyyy mm dd format string (date) expiring at subscription expiry date in yyyy mm dd format string (date) i want to see the details of my subscriptions use the endpoint /v2/subscriptions/{id} to see the details of your expired or active subscriptions provide your subscription id 📌 subscription id is displayed in the response body after successfully submitting a webhook subscription via experience changes endpoints replace {api key} with your api key request template curl x 'get' \\ 'https //api coresignal com/cdapi/v2/subscriptions/{subscription id}' \\ h 'accept application/json' \\ h 'apikey {api key}' 3\ send the request 4\ you will see the following information in the response body { "id" "c8e295c0 2f85 473d 8bef 350526e6b30a", "status" "active", "created at" "2024 09 18", "expiring at" "2024 12 18", "entity" "member experience", "es dsl query" null, "filters" null, "last webhook sent" "2024 09 30" } data point description data type id subscription identification key string status subscription status (active or expired) string created at subscription start date in yyyy mm dd format string (date) expiring at subscription expiry date in yyyy mm dd format string (date) entity subscription entity string es dsl query es dsl query used to subscribe to changes in a list of profiles string last webhook sent time of last message sent to your webhook url in yyyy mm dd format string (date) i want to renew my subscription use the endpoint /v2/subscriptions/{subscription id}/renew to renew your subscriptions a subscription can be renewed for up to 1 year if subscription renewal would exceed this period, the request will be cancelled provide your subscription id replace {api key} with your api key request template curl x 'post' \\ 'https //api coresignal com/cdapi/v2/subscriptions/{subscription id}/renew' \\ h 'accept application/json' \\ h 'apikey {api key}' 3\ send the request 4\ you will see the following information in the response body { "id" "4e11dcae 9bfb 4edb b4f6 a0991b20fb50", "status" "active", "created at" "2025 04 24t12 00 00 000000", "expiring at" "2025 10 24t12 00 00 000000", } data point description data type id subscription identification key string status subscription status string created at subscription start date string (date) expiring at subscription expiry date string (date) i want to delete my subscription use the endpoint delete /v2/subscriptions/{id} to make your subscriptions inactive use your subscription id as input to request updates of employee profiles or experience changes refer to the template below template curl x 'delete' \\ 'https //api coresignal com/cdapi/v2/subscriptions/{subscription id}' \\ h 'accept / ' \\ h 'apikey {api key}'