• Virtual Marketer CRM logo
    Virtual Marketer CRMDocumentation
  • Introduction
Getting Started
  • Quickstart
  • Core Concepts
Connect your AI
  • Custom connector
  • CLI & editors
  • Rate limits
Integrations
  • MCP
  • Webhooks
  • Website leads
  • OpenAPI 3.1.0
  • N8N
  • WhatsApp API
App guide
  • Dashboard
  • Inbox
  • Records
  • Profile
  • Company
  • Lead sending
  • API Keys
  • Filter Syntax
Licensing & security
  • Architecture & Security
  • Go back
  1. Introduction
  3. OpenAPI 3.1.0
OverviewAccept a relation requestPOSTAdd a send-as address to a connected accountPOSTAdd an organization's unbilled time to a draft documentPOSTArchive or restore a projectPOSTAttach a file to a projectPOSTAttach a file to an organizationPOSTBrowse a Sales Navigator listPOSTCalendar ChangedWEBHOOKCalendar Event ChangedWEBHOOKCancel a relation requestPOSTChat DeletedWEBHOOKChat UpdatedWEBHOOKConnect a mailbox over IMAP and SMTPPOSTContact CreatedWEBHOOKContact DeletedWEBHOOKContact UpdatedWEBHOOKConvert an offer to an order or invoicePOSTCreate a contactPOSTCreate a dealPOSTCreate a servicePOSTCreate a taskPOSTCreate a webhook subscriptionPOSTCreate an organizationPOSTCreate many contactsPOSTCreate many dealsPOSTCreate many organizationsPOSTCreate many servicesPOSTCreate many tasksPOSTCreate or update a billing documentPUTCreate or update a projectPUTCreate or update a recurring invoice seriesPOSTCreate or update a signaturePOSTCreate or update a teamPOSTCreate or update a time entryPUTDeal CreatedWEBHOOKDeal DeletedWEBHOOKDeal UpdatedWEBHOOKDelete a contactDELETEDelete a dealDELETEDelete a draft billing documentDELETEDelete a projectDELETEDelete a project attachmentDELETEDelete a project commentDELETEDelete a recurring invoice seriesDELETEDelete a serviceDELETEDelete a taskDELETEDelete a teamDELETEDelete a time entryDELETEDelete a webhook subscriptionDELETEDelete an attachmentDELETEDelete an organizationDELETEDelete many contactsDELETEDelete many dealsDELETEDelete many organizationsDELETEDelete many servicesDELETEDelete many tasksDELETEDelete one of the caller's own signaturesDELETEDiscard a message draftDELETEEdit a project commentPATCHEmail DeletedWEBHOOKEmail ReceivedWEBHOOKExport bookings as a DATEV BuchungsstapelGETGet a calendar by IDGETGet a calendar event by IDGETGet a contact by IDGETGet a deal by IDGETGet a messaging thread by IDGETGet a service by IDGETGet a single billing documentGETGet a single projectGETGet a single teamGETGet a single time entryGETGet a social profilePOSTGet a task by IDGETGet a webhook subscriptionGETGet activitiesPOSTGet an organization by IDGETGet calendar eventsPOSTGet calendarsPOSTGet contactsPOSTGet contacts configurationGETGet dealsPOSTGet deals configurationGETGet messaging threadsPOSTGet organizationsPOSTGet organizations configurationGETGet own user profileGETGet servicesPOSTGet services configurationGETGet tasksPOSTGet tasks configurationGETGet the caller's running timerGETGet the e-invoice XML of an invoiceGETGet the monthly revenue forecastGETGet the organization's billing profileGETGet usersPOSTInfer a likely email address from the pattern a domain already usesPOSTList a project's attachmentsGETList a project's commentsGETList an organization's attachmentsGETList offers, orders, invoices and credit notesGETList or fetch social postsPOSTList own connected accountsGETList post comments or reactionsPOSTList projectsGETList received relation requestsPOSTList recurring invoice seriesGETList Sales Navigator listsPOSTList Sales Navigator search parametersPOSTList signatures available to the callerGETList teamsGETList the send-as addresses of a connected accountGETList the WhatsApp groups a paired number is inGETList time entriesGETMessage DeletedWEBHOOKMessage ReactionWEBHOOKMessage ReceivedWEBHOOKMessage UpdatedWEBHOOKMove a billing document to another statePOSTOrganization CreatedWEBHOOKOrganization DeletedWEBHOOKOrganization UpdatedWEBHOOKPost a comment on a projectPOSTPreview the invoice lines an organization's unbilled time would produceGETRead the pairing state of a WhatsApp sessionGETRecord a payment against an invoicePOSTRelation CreatedWEBHOOKRemove a send-as addressDELETERender a billing document as PDFGETReplace the set of users allowed to send as an aliasPUTRun a Sales Navigator search from a URLPOSTSave a lead or account to a Sales Navigator listPOSTSave a message draftPOSTSearch Sales Navigator companies (accounts)POSTSearch Sales Navigator people (leads)POSTSend a billing document by emailPOSTSend a chat messagePOSTSend a relation requestPOSTSend a WhatsApp message, optionally with attachmentsPOSTSend an emailPOSTService CreatedWEBHOOKService DeletedWEBHOOKService UpdatedWEBHOOKStart a chatPOSTStart a running timerPOSTStart a WhatsApp session on the organization's WAHA instancePOSTStop a running timerPOSTStream a project attachmentGETStream an attachmentGETTake an organization's time back off a draft documentPOSTTask CreatedWEBHOOKTask DeletedWEBHOOKTask UpdatedWEBHOOKUnpair the WhatsApp number from a sessionDELETEUpdate a contactPUTUpdate a dealPUTUpdate a servicePUTUpdate a taskPUTUpdate a teamPUTUpdate an organizationPUTUpdate many contactsPUTUpdate many dealsPUTUpdate many organizationsPUTUpdate many servicesPUTUpdate many tasksPUTUpdate the organization's billing profilePUT

Create a contact

Creates a new contact. First name and last name are required. All other fields are optional.

apiKeyAuth
x-api-key<token>

In: header

application/json

POST
/v1/contacts

Authorization

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

firstName*string
Lengthlength <= 255
lastName*string
notes?|

Markdown content

organizationIds?array<>
Default[]
userIds?array<>
Default[]
dealIds?array<>
Default[]
taskIds?array<>
Default[]
customFieldValues?array<>
Default[]
identifiers?array<>

Messaging channels for this contact. Each item is { provider, value }. provider is one of mail, google, outlook, whatsapp. value is the email address or phone number.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://loading/api/v1/contacts" \  -H "Content-Type: application/json" \  -d '{    "firstName": "string",    "lastName": "string"  }'

API key authentication. Create an API key in your user profile and include it in the x-api-key header.

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "firstName": "string",
  "lastName": "string",
  "avatarUrl": "string",
  "notes": {},
  "identifiers": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "provider": "google",
      "value": "string",
      "messagingId": "string",
      "displayName": "string",
      "profileUrl": "string",
      "source": "manual"
    }
  ],
  "createdAt": "string",
  "updatedAt": "string",
  "organizations": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string"
    }
  ],
  "users": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "firstName": "string",
      "lastName": "string",
      "avatarUrl": "string",
      "email": "user@example.com"
    }
  ],
  "deals": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string"
    }
  ],
  "tasks": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string",
      "type": "userPendingAuthorization"
    }
  ],
  "customFieldValues": [
    {
      "columnId": "b0676e1a-d8a0-4c5f-99e7-a0ee8909f6dd",
      "value": "string"
    }
  ]
}
"string"
"string"
"string"
"string"