cobra CRM Cloud - API Docs
Start
Website
cobra Knowledge Portal
cobra CRM Cloud - API Docs
  • Welcome to our Developer Portal
  • Hybrid REST / GraphQL API
  • GraphQL API Endpoints
  • Versioning
  • Translated Responses
  • Tenant Context
  • Authentication
  • Pagination, Sorting, Filtering in GraphQL
  • Date/Time Format And Time Zones
  • Usage Policy
  • Access
  • Auth
  • cobra CRM
    • People360
    • Touchpoints
      • Documents
      • Settings
      • Management
      • Ai
      • Retrieve the details of an existing touchpoint by its IDGET
      • Create a new touchpointPOST
      • Update an existing touchpoint by its IDPUT
      • Delete a touchpoint by its IDDELETE
      • Delete multiple touchpoints by their IDsDELETE
      • Perform an input validation without changing the data set or creating a touchpoint in the database (calculated fields are returned)POST
      • Add one or more tags to selected touchpointsPOST
      • Remove one or more tags from selected touchpoints by their IDsPOST
      • Delete a person involved from the touchpoint by its IDDELETE
      • Update the priority for multiple touchpoints by their IDsPUT
      • Update the priority for a touchpoint by its IDPUT
      • Add the current mood to a touchpoint by its IDPUT
      • Move touchpoints from one person to anotherPOST
    • Companies
  • cobra Event
  • Tickets
  • Integrations
  • TenantInfo
logoPowered by Apidog
  1. cobra CRM
  2. Touchpoints

Create a new touchpoint

POST/touchpoints
Last modified: 24 days ago

Request

Header Params
X-Integration-Name
string 
required

Integration name

Example:
API Documentation
X-Integration-Provider
string 
required

Integration provider

Example:
cobra GmbH
X-Cobra-TenantId
string 
required

Tenant ID

Example:
12e39e53-ece1-4d8d-8958-e782de1dbef0
X-Integration-Contact
string 
optional

Integration contact

Example:
info@cobra.de
Accept-Language
string 
optional
Example:
de
Body Params application/json
topic
string 
required
>= 1 characters<= 200 characters
details
string  | null 
optional
<= 100000 characters
source
string  | null 
optional
<= 200 characters
sourceUrl
string  | null 
optional
touchDate
string <date-time>
required
touchTime
string <date-time> | null 
optional
currentMood
integer <int32>
optional
>= -2<= 2
peopleInvolved
array[object (PeopleInvolvedDto) {8}] 
required
>= 1 items
peopleId
string  | null 
optional
firstname
string  | null 
optional
lastname
string  | null 
optional
businessCardId
string  | null 
optional
iconUrl
string  | null 
optional
highlighted
boolean 
optional
participantRole
string  | null 
optional
integrationInitiator
object (IntegrationInitiatorDto) 
required
channel
object (AbstractChannelDto) 
optional
priority
string  | null 
optional
isOutgoing
boolean 
optional
orgaTags
array[object (CobraTagForEmbeddedDto) {2}]  | null 
required
id
string  | null 
optional
text
string  | null 
optional
<= 200 characters
objectLinks
array[object (ObjectLinkForCreateDto) {2}]  | null 
required
relationIds
$ref(#/definitions/1878512)[] | null 
optional
Could not resolve '#/definitions/1878512'
identifier
string  | null 
optional
note
string  | null 
optional
<= 10000 characters
Example
Not configured

Request samples

Responses

returns if the touchpoint was correctly created.(201)
returns if the request violates a validation rule.(400)
returns if you do not have the required permissions.(403)
returns if the touchpoint was correctly created.
HTTP Code: 201
Content Type : JSONapplication/json
Data Schema
data
object (TouchpointDto) 
optional
id
string  | null 
optional
createdBy
string  | null 
optional
modifiedBy
string  | null 
optional
dateCreated
string <date-time> | null 
optional
dateModified
string <date-time> | null 
optional
createdByUserId
string <uuid> | null 
optional
modifiedByUserId
string <uuid> | null 
optional
topic
string  | null 
optional
details
string  | null 
optional
source
string  | null 
optional
sourceUrl
string  | null 
optional
touchNote
object (TouchpointNoteDto) 
optional
objectLinksDefinitions
array[object (ObjectLinksDto) {3}]  | null 
optional
files
array[object (TouchpointFileDto) {11}]  | null 
optional
touchDate
string <date-time> | null 
optional
touchTime
string <date-time> | null 
optional
currentMood
integer <int32>
optional
peopleInvolved
array[object (PeopleInvolvedDto) {8}]  | null 
optional
channel
object (AbstractChannelDto) 
optional
priority
string  | null 
optional
isOutgoing
boolean 
optional
orgaTags
array[object (CobraTagForEmbeddedDto) {2}]  | null 
optional
message
string  | null 
optional
metaData
object (ResponseMetaData) 
optional
totalResults
integer <int32>
optional
responseTimeStamp
string <date-time>
optional
statusCode
integer <int32>
optional
Example
Not configured
Last modified: 24 days ago