Add an advisory contact
const url = 'https://zkao.io/api/v1/projects/example/advisory-contacts';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"email":"example","organization":"example","tier":"EMBARGO","software":[{"owner":"example","name":"example"}],"name":"example","title":"example","notes":"example","tags":["example"]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://zkao.io/api/v1/projects/example/advisory-contacts \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "email": "example", "organization": "example", "tier": "EMBARGO", "software": [ { "owner": "example", "name": "example" } ], "name": "example", "title": "example", "notes": "example", "tags": [ "example" ] }'Requires scope: contacts:write. Puts one address on the programme’s contact list.
software says which of the project’s repositories this contact runs, and is required. It is what every notice is matched on: a contact who runs nothing is told nothing.
The contact starts PENDING_VERIFICATION, and an unconfirmed address receives nothing embargoed. The confirmation mail is sent from the app, not by this call, so nothing is emailed to the address you send here.
There is no endpoint that reads the contact list back. It is other people’s work addresses and the record of who hears about a vulnerability early.
Authorizations
Section titled “Authorizations”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters”Request Bodyrequired
Section titled “Request Bodyrequired”object
The organisation this contact speaks for.
How early this contact is told. EMBARGO hears first and alone, DOWNSTREAM joins once a patch exists, ANNOUNCE learns at public disclosure.
The repositories this contact runs. At least one.
object
Responses
Section titled “ Responses ”Created
object
object
PENDING_VERIFICATION until the contact confirms the address. An unconfirmed address receives nothing embargoed.
The software this contact runs, which notices are matched on.
object
Examplegenerated
{ "contact": { "id": "example", "email": "example", "organization": "example", "tier": "example", "status": "example", "software": [ { "owner": "example", "name": "example" } ], "createdAt": "2026-04-15T12:00:00Z" }}Invalid request
object
object
Budget_below_minimum only: the least the launch could have reserved, in credits. A diff scan’s first scan of a repository also builds its overview, so its minimum is higher.
Example
{ "error": { "code": "unauthorized" }}Missing, malformed, expired, or revoked token
object
object
Budget_below_minimum only: the least the launch could have reserved, in credits. A diff scan’s first scan of a repository also builds its overview, so its minimum is higher.
Example
{ "error": { "code": "unauthorized" }}The token lacks the required scope
object
object
Budget_below_minimum only: the least the launch could have reserved, in credits. A diff scan’s first scan of a repository also builds its overview, so its minimum is higher.
Example
{ "error": { "code": "unauthorized" }}Resource not in this token’s project or repo allowlist
object
object
Budget_below_minimum only: the least the launch could have reserved, in credits. A diff scan’s first scan of a repository also builds its overview, so its minimum is higher.
Example
{ "error": { "code": "unauthorized" }}That address is already on the programme’s contact list.
object
object
Budget_below_minimum only: the least the launch could have reserved, in credits. A diff scan’s first scan of a repository also builds its overview, so its minimum is higher.
Example
{ "error": { "code": "unauthorized" }}