Are you a cracked engineer? See your Vamo profile
vamo

Add a contact note

POST https://api.vamotalent.ai/v2/contacts/{contactId}/notes
Access
Authenticated
contact:update
Cost
Free
Rate limit
120 / minute per account
Quota
None

Add a note about one person: why they stood out, what you learned, what to do next. It is saved with its author and the time, and is shown wherever that person appears, on their profile and on every shortlist they are on. It can be edited (PATCH) or deleted (DELETE) afterwards by its id. It takes a contact id: to write about a developer you have not saved, save them first with POST /v2/contacts, which answers the contact id. Sending the same note twice makes two notes.

Path parameters

  • contactId string required
    max 16 chars

Request body AddContactNoteRequest application/json

  • body string required

    The note, in plain words. 1 to 10000 characters.

    max 10000 chars

Responses

The note as saved

  • id string required

    The note id.

  • contactId string required

    The contact the note is about.

  • body string required

    The note text, as written.

  • author NoteAuthor required

    Who wrote a note, or who last edited it.

    • kind string required

      What wrote the note: `member` is a person on the account, `key` is an API key, `tool` is an AI tool a person signed in, and `system` is Vamo.

      memberkeytoolsystem
    • id string | null required

      The id of that member, key or tool connection. Null for `system`.

    • name string | null required

      What to call them: the person’s name for a member, the key’s label for a key, the tool’s name for a tool, and `Vamo` for `system`. Null when no name is held.

  • createdAt string required

    When the note was written, as an ISO 8601 instant.

  • updatedAt string | null required

    When the note was last edited, as an ISO 8601 instant. Null when it was never edited.

  • editedBy object required
    • kind string required

      What wrote the note: `member` is a person on the account, `key` is an API key, `tool` is an AI tool a person signed in, and `system` is Vamo.

      memberkeytoolsystem
    • id string | null required

      The id of that member, key or tool connection. Null for `system`.

    • name string | null required

      What to call them: the person’s name for a member, the key’s label for a key, the tool’s name for a tool, and `Vamo` for `system`. Null when no name is held.

vamo

© 2026 Vamo Holdings, Inc.