CorefinityCorefinityDocs
Open the Control PanelControl Panel
Support · 12 of 15

List people who can follow a ticket

Answers the people you may add as followers, as the picker on the ticket page offers them: up to six active people whose name contains search, from the companies that may follow the ticket. For an agency these are the ticket's client company and the agency itself; for a client, its own company.

GET/api/support/tickets/{ticket}/subscriber-candidates

Path parameters

ticketintegerRequired

The number of a ticket. Digits only. At least 1.

Query parameters

searchstring

Part of a name. The first six people when left out. Up to 255 characters.

Returns

200 The people you may add.

Fields of the 200 answer
candidatesarray of objectsRequired

Up to 6 items.

Fields of each item
company_namestring or nullRequired
emailstring or nullRequired
idintegerRequired

At least 1.

namestringRequired
searchstringRequired
ticket_idintegerRequired

At least 1.

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403forbiddenThe person is not allowed to do this.
403scope_requiredUse a token with the scope named in scope.
404noneCheck the id. You see only what your account can reach.
422invalidFix the field named in field; errors says why.
429rate_limitedWait for the seconds in Retry-After.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl https://manage.corefinity.com/api/support/tickets/48210/subscriber-candidates \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "candidates": [
    {
      "company_name": "Harbour & Finch",
      "email": "[email protected]",
      "id": 2042,
      "name": "Tom Harbour"
    }
  ],
  "search": "Tom",
  "ticket_id": 48210
}
Try it
Held in this tab's memory only. Never stored or sent to us.

Use a token with only the read scope. How to make one

Was this helpful?
Open in ClaudeOpen in ChatGPT