• Virtual Marketer CRM Logo
    Virtual Marketer CRMDokumentation
  • Einführung
Erste Schritte
  • Quickstart
  • Kernkonzepte
KI verbinden
  • Custom Connector
  • CLI & Editoren
  • Ratenlimits
Integrationen
  • MCP
  • Webhooks
  • Leads von der Website
  • OpenAPI 3.1.0
  • N8N
  • WhatsApp-API
App-Leitfaden
  • Dashboard
  • Posteingang
  • Datensätze
  • Profil
  • Unternehmen
  • Lead-Versand
  • API-Keys
  • Filter-Syntax
Lizenzen & Sicherheit
  • Architektur & Sicherheit
  • Zurück
  1. Einführung
  3. OpenAPI 3.1.0
ÜbersichtAccept 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

Connect a mailbox over IMAP and SMTP

Verifies the credentials against the mail server before storing anything, then creates the connected account and starts its backfill. Credentials are encrypted at rest and are never returned. Setting shared makes the mailbox belong to the organization rather than the calling user, and requires organization-administrator rights. An organization mailbox is visible only inside its own workspace.

apiKeyAuth
x-api-key<token>

In: header

application/json

POST
/v1/messaging/connect/imap

Authorization

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

emailAddress*string
Match^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
Formatemail
displayName?string
Lengthlength <= 255
imapHost*string
Match^[a-z0-9.-]+$
Length1 <= length <= 253
imapPort?integer
Default993
Range1 <= value <= 65535
imapSecure?boolean
Defaulttrue
smtpHost*string
Match^[a-z0-9.-]+$
Length1 <= length <= 253
smtpPort?integer
Default587
Range1 <= value <= 65535
smtpSecure?boolean
Defaultfalse
username*string
Length1 <= length <= 320
password*string
Length1 <= length <= 1024
shared?boolean
Defaultfalse
backfillMaxAgeDays?integer
Default90
Range1 <= value <= 3650

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://loading/api/v1/messaging/connect/imap" \  -H "Content-Type: application/json" \  -d '{    "emailAddress": "user@example.com",    "imapHost": "string",    "smtpHost": "string",    "username": "string",    "password": "string"  }'

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

{
  "connected": true,
  "connectedAccountId": "ac03972a-5ca5-43c5-b96f-c519ac843b7a"
}
"string"
"string"
"string"
{
  "connected": true,
  "connectedAccountId": "ac03972a-5ca5-43c5-b96f-c519ac843b7a"
}
"string"