- 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
- Business Cards
- Update an existing address in a business card of a person
- Delete an address from a specific business card of a person by its address ID
- Create a new address in a person's existing business card
- Update an existing business card of a specific person by the business card ID
- Retrieve the details of an existing business card from a specific person by the people ID and the business card ID
- Delete a business card form a specific person by the business card ID
- Retrieve the details of all existing business cards from a specific person by the people ID
- Create a new business card for an existing person
- Retrieve the details of an existing business card from a specific person only by the business card ID
- Delete multiple business cards from a person by their IDs
- Retrieve an existing person's business card as a vCard (.vcf)
- Relations
- Retrieve all relations of a given specific person by relation category
- Relate two people with each other
- Update a specific relation of a person
- Remove a relation between two people
- Creates one or more existing relations to multiple people
- Update one or more existing relations of a person
- Remove multiple relations of one or more people
- Settings
- Management
- Create one or more new entries for people properties
- Delete multiple entries for people properties from a list by their IDs
- Delete an entry for people property from a list by its ID
- Create one or more personality tags
- Delete multiple personality tags from the list by their IDs
- Delete a personality tag from the list by its ID
- Create one or more new orga tags
- Delete multiple orga tags from the list by their IDs
- Delete an orga tag from the list by its ID
- Create one or more new address types
- Delete multiple address types from the list by their IDs
- Delete an address type from the list by its ID
- Create one or more life cycles
- Delete multiple life cycles from the list by their IDs
- Delete a life cycle from the list by its ID
- Create one or more new manager roles that can be assumed by responsible people
- Delete multiple manager roles from the list by their IDs
- Delete a manager role from the list by its ID
- Create one or more new address types
- Delete multiple address types from the list by their IDs
- Delete an address type from the list by its ID
- Batch
- PeopleMerge
- Retrieve people filtered by email or employee status or bothGET
- Retrieve a list of peopleGET
- Create a new personPOST
- Retrieve the details of an existing person by its IDGET
- Update an existing person by its IDPUT
- Delete a person by its IDDELETE
- Retrieve a quicklook of an existing person by its IDGET
- Update one or more existing peoplePUT
- Create one or more peoplePOST
- Delete multiple people by their IDsDELETE
- Update the note on a person by its IDPUT
- Update the list of orga tags on a person by its ID (the list will be overwrite)PUT
- Update the list of personality tags on a person by its ID (the list will be overwrite)PUT
- Update the lifecycle on a person by its IDPUT
- Retrieve all type of profile images for a person by its IDGET
- Upload a replacement profile image for a person by its IDPOST
- Delete the profile image of a person by its IDDELETE
- Touchpoints
- Documents
- Settings
- Management
- Ai
- Retrieve the details of an existing touchpoint by its ID
- Create a new touchpoint
- Update an existing touchpoint by its ID
- Delete a touchpoint by its ID
- Delete multiple touchpoints by their IDs
- Perform an input validation without changing the data set or creating a touchpoint in the database (calculated fields are returned)
- Add one or more tags to selected touchpoints
- Remove one or more tags from selected touchpoints by their IDs
- Delete a person involved from the touchpoint by its ID
- Update the priority for multiple touchpoints by their IDs
- Update the priority for a touchpoint by its ID
- Add the current mood to a touchpoint by its ID
- Move touchpoints from one person to another
- Companies
- Relations
- Documents
- Settings
- Management
- Create one or more new tags
- Delete multiple tags from the list by their IDs
- Delete a tag from the list by its ID
- Create one or more entries for number of employees
- Delete multiple entries for number of employees from the list by their IDs
- Delete an entry for number of employees from the list by its IDs
- Create one or more entries for number of customers
- Delete multiple entries for number of customers from the list by their IDs
- Delete an entry for number of customers from the list by its IDs
- Create one or more legal forms
- Delete multiple legal forms from the list by their IDs
- Delete a legal form from the list by its IDs
- Create one or more reference number types
- Delete multiple reference number types from the list by their IDs
- Delete a reference number type from the list by its ID
- Create one or more industry sectors
- Delete multiple industry sectors from the list by their IDs
- Delete an industry sector from the list by its ID
- Create one or more relation types
- Delete multiple relation types from the list by their IDs
- Updates a relation Type
- Delete a relation type from the list by its ID
- Create one or more life cycles
- Delete multiple life cycles from the list by their IDs
- Delete a life cycle from the list by its ID
- Batch
- Bank Accounts
- Logos
- Create a new address for an exisiting company
- Update an existing address of a specific company by its ID This endpoint should be only used by the frontend
- Delete an address from a specific company by its ID
- Retrieve the details of an existing company by its ID
- Update an existing company by its ID
- Delete a company by its ID
- Retrieve the details of a company by its domain
- Create a new company
- Update the note on a company by its ID
- Update the list of tags on a company by its ID (the list will be overwrite)
- Update the lifecycle on a company by its ID
- Delete multiple companies by their IDs
- Add one or more tags to selected companies
- Remove one or more tags from selected companies by their IDs
- Add a new phone number to an exisitng company
- Update an existing phone number of a specific company by its ID
- Delete a phone number form a specific company by its ID
- Perform an input validation without changing the data set or creating a company in the database (calculated fields are returned)
- Add a new e-mail address to an existing company
- Update an existing e-mail address of a specific company by its ID
- Delete an e-mail address form a specific company by its ID
- cobra Event
- Settings
- Booking form field sets
- Cancellation conditions
- Contact person templates (copy list)
- Contributor roles (tenant list)
- Event categories (tenant list)
- Online meeting platforms (vendor list)
- Orga tags (adhoc list)
- Tax rates (vendor list)
- Portal tags (tenant list)
- Gets the event settings for the current tenant
- Updates the event settings for the current tenant
- Validates the event settings
- Event files
- Event images
- Contact person template images
- Bookings
- Creates a new booking (public)
- Gets a booking by its ID
- Gets the confirmation infos for a successful booking (public)
- Deletes an existing booking
- Deletes a list of bookings
- Calculates the current cancellation rules that apply when cancelling a booking including all tickets
- Cancels a booking and all belonging tickets
- Cancels a booking and all belonging tickets
- Calculates the current cancellation rules that apply when cancelling a booking including all tickets
- Sets the booker information for a booking
- Sends an invoice mail to the booker
- Sets the invoice number of an external booking
- Change the status of a payment
- Collects the booking history statistics for an event
- Collects the booking history actions for an event
- Invitations
- Gets details of an invitation (public)
- Gets an invitation by its ID
- Gets details of an invitation (public)
- Deletes an existing invitation
- Reject an Invitation. If a ticket was already bought using this invitation, the ticket is cancelled.
- Deletes a list of invitations
- Creates a new invitation for an event
- Validates an invitation
- Send an invitation e-mail to a list of persons to invite
- Send an filtered invitation e-mail to a list of persons to invite
- Send an invitation free e-mail to a list of persons to invite
- Send an filtered invitation free e-mail to a list of persons to invite
- Sets information data for the invited person
- Imports invitations from a file
- Generates a preview for a file import
- Exports invitations for an event
- Change the status of a list of participants
- Event tickets
- Gets an event ticket by its ID
- Add custom integration data to an event ticket
- Get an event ticket summary
- Change the status of a list of participants
- Resend event tickets to a list of participants
- Send free mails to a list of participants
- Send free mails to filtered participants
- Validates an event ticket and checks it in
- Sets participant information data
- Exports event tickets
- Website images
- Websites
- Gets a website by its ID
- Gets an event by its ID (public)
- Updates an existing website
- Gets the field set for booking forms that is used by an event (public)
- Deletes an existing website
- Gets a portal config by its url (public)
- Creates a new website
- Deletes a list of websites
- Validates a website
- Validates a website
- Replaces all references to existing event portal by another event portal: all events using the original portal will migrate to the replacement portal.
- Enables or disables the publication of a website
- Validates the publication of a website
- Gets an event by its ID
- Updates an existing event
- Deletes an existing event
- Creates a new event
- Deletes a list of events
- Validates an event
- Get event as iCal format
- Duplicates an event
- Updates the note of an event
- Updates the publication of an event
- Validates the publication of an event
- Settings
- Tickets
- Integrations
- TenantInfo
- Returns general information such as the TenantId and contact details of the client currently logged in.
- This can be used to read out the client's currently set tariff, including all available modules and their functions contained in the tariff.
- Returns general information about the tenants subscription.
Retrieve people filtered by email or employee status or both
GET
https://api.cobra.de/v1/crm/people/filter
Last modified:2024-12-09 08:45:57
Request
Query Params
mail
stringÂ
optional
status
stringÂ
optional
InternalEmployee For an internal Employee.
ExternalEmployee For an external Employee.
ExEmployee For an ex Employee.
option
stringÂ
optional
all All ("mail", "status") parameters.
email Only the "mail" parameter.
status Only the "status" parameter.
Header Params
X-Integration-Name
stringÂ
required
Example:
API Documentation
X-Integration-Provider
stringÂ
required
Example:
cobra GmbH
X-Cobra-TenantId
stringÂ
required
Example:
12e39e53-ece1-4d8d-8958-e782de1dbef0
X-Integration-Contact
stringÂ
optional
Example:
info@cobra.de
Accept-Language
stringÂ
optional
Example:
de
Request samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.cobra.de/v1/crm/people/filter' \
--header 'X-Integration-Name: API Documentation' \
--header 'X-Integration-Provider: cobra GmbH' \
--header 'X-Cobra-TenantId: 12e39e53-ece1-4d8d-8958-e782de1dbef0'
Responses
🟢200OK
application/json
Body
data
array[object (PeopleForFilter) {4}]  | nullÂ
optional
id
string  | nullÂ
optional
email
string  | nullÂ
optional
firstname
string  | nullÂ
optional
lastname
string  | nullÂ
optional
message
string  | nullÂ
optional
metaData
object (ResponseMetaData)Â
optional
totalResults
integer <int32>
optional
responseTimeStamp
string <date-time>
optional
statusCode
integer <int32>
optional
Example
{
"data": [
{
"id": "string",
"email": "string",
"firstname": "string",
"lastname": "string"
}
],
"message": "string",
"metaData": {
"totalResults": 0,
"responseTimeStamp": "2019-08-24T14:15:22Z"
},
"statusCode": 0
}
🟠400Bad Request
Modified at 2024-12-09 08:45:57