cobra CRM Cloud - API Docs
Start
Websitecobra Knowledge Portal
Start
Websitecobra Knowledge Portal
  1. Bookings
  • 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
    • Get a user by id
    • Update an existing user
    • Delete a user
    • Create a new user
    • Deactivate an existing user
    • Activate an existing user
    • Reset the password for an existing user
    • Delete multiple users by id
    • Get available roles for a tenant
    • Get user settings by userId.
    • Update user settings.
  • Auth
    • Get the OAuth2 configuration URL and the client ID.
    • Logs in to cobra with the login data and returns a bearer token if successful.
    • This is an implementation of the Introspect endpoint as defined in RFC 7662
  • cobra CRM
    • People360
      • Business Cards
        • Update an existing address in a business card of a person. If the address to be updated is the new favorite, the old favorite will lose its favorite status. If the previous favorite is updated and should no longer be a favorite, then there is no longer an
        • Delete an address from a specific business card of a person by its address ID. If the favorite address is deleted and only one other address remains, this address becomes the new favorite. Otherwise, no new favorite is set
        • Create a new address in a person's existing business card. If the address to be created becomes the new favorite, the old favorite will lose its status as a favorite
        • 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
        • Set only the IsActive state of an existing business card of 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
        • Connects a persons business card with a company. The business card must not be private.
        • Retrieve an existing person's business card as a vCard (.vcf)
        • Validates a business card before it is created or updated.
        • Validates a business card before it is created or updated.
      • 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
        • Validates a relation before it is created or updated.
        • Validates a relation before it is created or updated.
      • Settings
        • Update the settings for People360 such as postal address validation etc
        • Update the settings for People360 such as postal address validation, default Lifecycle etc.
      • 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
        • Creates an index for the address quality service. If the index already exists, this operation will do nothing. The index should be opened after creation. The index will be empty. If person or company data is created or updated after the index creation, th
        • Deletes an index for the address quality service.
        • Opens an index of the address quality service. Sometimes the index could be closed due to some unexpected reason, which will cause person and company search and duplicate check features not working. If the index is already opened, this operation will do n
        • Closes an index of the address quality service. The index functions will be unavailable when the index is closed, which will cause person and company search and duplicate check features not working. There is usually no reason to close the index.
        • Triggers the event to reinstall an index of the address quality service. The existing index will be deleted and a new index will be created and opened. The person or company data will be reindexed. This endpoint should be used if many data is not indexed
        • Checks if the index of the address quality service is working properly by creating, searching and deleting an index dummy entry.
        • 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
        • Replaces all references to existing Personality by another Personality.
        • 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
        • Replaces all references to existing orga tag by another orga tag.
        • 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
        • Replaces all references to existing address type by another address type.
        • 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
        • Update a lifecycle entry by its ID and update all associated people records.
        • Replaces all references to existing Lifecycle by another Lifecycle.
        • 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
        • Replaces all references to existing role by another role.
        • 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
        • Replaces all references to existing email address type by another email address type.
        • Create one or more new company relation types
        • Delete multiple company relation types from the list by their IDs
        • Delete an company relation type from the list by its ID
      • Batch
        • Start a new process to validate addresses
        • Cancel an ongoing process that validates addresses
        • A data set with information about the process
      • PeopleMerge
        • If 2 people have been merged, this end point must be called at the end.
      • Integration Data
        • Returns all integration data entries stored on a people object.
        • Creates or replaces the integration data entry for a given integration key.
        • Removes the integration data entry for a given integration key.
      • Calendar
        • Lists calendar events from the local snapshot
        • Creates a calendar event in the connected outlook calendar and invites selected attendees via email
        • Gets a single calendar event by id from the connected Outlook calendar
        • Partially updates an existing calendar event
        • Cancels an existing calendar event
      • _Root (People)
        • Retrieve people by filter
        • Retrieve a list of people
        • Create a new person
        • Retrieve a person
        • Update a person
        • Delete a person
        • Retrieve a person's quicklook
        • Update several people
        • Create several people
        • Delete several people
        • Update a person's note
        • Replace all tags on a person
        • Read a person's tags
        • Add tags to a person
        • Remove tags from a person
        • Add and/or remove tags on several people
        • Replace all personalities on a person
        • Update a person's lifecycle
        • Parse clipboard text to create a person
        • Validate a person
        • Export people as a CSV or XLSX file
        • Add and/or remove tags on several people, with statistics
        • Start a tag job over many people
        • Read the status of a tag job
        • Cancel a running tag job
        • List the tags of a selection of people
      • _Root (ProfileImage)
        • Retrieve all type of profile images for a person by its ID
        • Upload a replacement profile image for a person by its ID
        • Delete the profile image of a person by its ID
    • Touchpoints
      • Documents
        • Upload a file to an existing touchpoint
        • Delete a file from a touchpoint by its ID
      • Settings
        • Configure which of the predefined touchpoint types and channels should be activated for use
        • Replaces the channels shown first when a touchpoint is created.
      • Management
        • Create one or more new tags
        • Create one or more call results
        • Delete multiple call results; entries in use and the last entry cannot be deleted
        • Rename a call result; the new text is copied into all touchpoints using it
        • Delete multiple tags from the list by their IDs; a tag still carried by a touchpoint is refused
        • Delete a call result; entries in use and the last entry cannot be deleted
        • Delete a tag from the list by its ID; a tag still carried by a touchpoint is refused
        • Point all touchpoints using this call result to another one
        • Point all touchpoints carrying this tag to another tag; a touchpoint carrying both keeps the other tag once
      • Ai
        • Use AI to generate an email text based on the last touchpoints
        • Use AI to generate an email text based on the last touchpoints
        • Uses AI to generate a recommendation of the next steps based on the last touchpoints
        • Uses AI to generate a recommendation of the next steps based on the last touchpoints
        • To create a CallTelephone Touchpoint template with phone a conversation guide via AI based on the recommendation data from the Touchpoint recommendation endpoint. No Touchpoint is created in the database, only a template for creation.
        • Uses AI to suggest follow-up tasks from the content of one touchpoint. The content comes with the request, so it works for a touchpoint that is not saved yet. Titles carry no person and no date; the due date is resolved from the time reference in the cont
      • Analytics
        • Counts how often a specific company appears in different touchpoints in the last 3 months.
        • Calculate the total turnover of a company over its entire history. The data of the turnover touchpoints will be evaluated. Different currencies are not taken into account. It is assumed that all entries have been made in one currency.
        • Counts how often a specific person appears in different touchpoints in the last 3 months.
        • Calculate the total turnover of a person over its entire history. The data of the turnover touchpoints will be evaluated. Different currencies are not taken into account. It is assumed that all entries have been made in one currency.
      • Email Touchpoints images
        • Uploads the provided image for the email touchpoint.
        • Deletes the image with the specified url from the email touchpoint.
        • Deletes all images of the email touchpoint.
      • Integration Data
        • Returns all integration data entries stored on a touchpoint object.
        • Creates or replaces the integration data entry for a given integration key.
        • Removes the integration data entry for a given integration key.
      • _Root (Touchpoints)
        • Retrieve the details of an existing touchpoint by its ID
        • Create a new touchpoint
        • Update an existing touchpoint by its ID
        • Read the tags of a touchpoint
        • Delete a touchpoint by its ID
        • Delete multiple touchpoints by their IDs
        • Validate a touchpoint input without persisting it
        • Add tags to a touchpoint
        • Remove tags from a touchpoint
        • Replace a touchpoint's tags
        • Add and/or remove tags on several touchpoints
        • 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
        • Send an existing touchpoint as email
        • Set analysis data for a touchpoint
        • Read the status of a tag job
        • Add and/or remove tags on several touchpoints, with statistics
        • Start a tag job over many touchpoints
        • Cancel a running tag job
        • List the tags of a selection of touchpoints
      • CommonFiles
        • Upload a file as a central common file, independent of any touchpoint
        • Delete a central common file by its URL
      • Create an email touchpoint and send the email.
    • Companies
      • Relations
        • Relate two companies with each other
        • Update a specific relation of a company
        • Remove a relation between two companies
        • Update one or more existing relations of a company
        • Remove multiple relations of one or more companies
        • Change the direction of the relation between two companies
      • Documents
        • Upload a file to an existing company
        • Delete a file from a company by its ID
      • Settings
        • Update the settings for Companies such as postal address validation etc.
        • Update the settings for Companies such as postal address validation, default Lifecycle etc.
      • 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
        • Replaces all references to existing tag by another tag.
        • 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
        • Update a lifecycle entry by its ID and update all associated company records.
        • Replaces all references to existing Lifecycle by another Lifecycle.
        • Create one or more new email address types
        • Delete multiple email address types from the list by their IDs
        • Delete an email address type from the list by its ID
        • Replaces all references to existing email address type by another email address type.
        • Create one or more relation managed by people role entries
        • Delete multiple relation managed by people role entries from the list by their IDs
        • Delete a relation managed by people role entry from the list by its IDs
        • Replaces all references to existing role by another role.
        • Renames a reference number type by its ID and updates all associated company records.
      • Batch
        • A data set with information about the process
        • Cancel an ongoing process that validates addresses
        • Start a new process to validate addresses
      • Bank Accounts
        • Upload a file for the direct debit mandate to a company bank account
        • Delete a file for the direct debit authorization from a company bank account
      • Logos
        • Upload a replacement logo for a company by its ID
        • Delete the logo from a company by its ID
        • Upload a logo for a company by its ID using the logo provider service api and delete the old logo
      • PeopleRelations
        • Create a new managed by person relation between a person and a company.
        • Creates new managed by person relations between persons and a company.
        • Updates managed by person relations between persons and a company
        • Deletes managed by person relations.
        • Updates a managed by person relation between a person and a company.
        • Deletes a managed by person relation.
      • Import
        • Upload an Excel or CSV file and parse it for import. Returns headers, sample rows, and a cache key for subsequent steps.
        • Request AI-generated column mapping suggestions based on the uploaded file.
        • Preview the first 20 rows with validation results and duplicate detection based on the provided mappings.
        • Start the import. Returns synchronously for up to 500 rows; otherwise returns a job ID for polling.
        • Poll the status of an async import job.
        • Download an Excel error report for a completed import job.
      • Integration Data
        • Returns all integration data entries stored on a company object.
        • Creates or replaces the integration data entry for a given integration key.
        • Removes the integration data entry for a given integration key.
      • _Root (Addresses)
        • Create a new address for an existing company If the entry to be created is marked as a favorite, the previous favorite loses its status. If no address has been marked as a favorite, an attempt is made to automatically determine the favorite based on the a
        • Update an existing address of a specific company by its ID If the entry to be updated is marked as a favorite, the previous favorite loses its status. If no address has been marked as a favorite, an attempt is made to automatically determine the favorite
        • Delete an address from a specific company by its ID If the entry to be deleted is marked as a favorite, a new favorite ist determined. If no address has been marked as a favorite, an attempt is made to automatically determine the favorite based on the add
        • Perform an input validation without changing the dataset or creating a company address in the database (calculated fields are returned).
      • _Root (Companies)
        • 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
        • Replace all tags on a company
        • Read a company's tags
        • Add tags to a company
        • Remove tags from a company
        • Update the lifecycle on a company by its ID
        • Delete multiple companies by their IDs
        • Add one or more tags to selected companies
        • Add and/or remove tags on several companies
        • Remove one or more tags from selected companies by their IDs
        • Add new phone numbers to an existing company. If the entry to be created is marked as a favorite, the previous favorite loses its status. If no phone has been marked as a favorite, an attempt is made to automatically determine the favorite based on the ty
        • Update existing phone numbers of a specific company by its ID. If the entry to be updated is marked as a favorite, the previous favorite loses its status. If no phone has been marked as a favorite, an attempt is made to automatically determine the favorit
        • Delete a phone number form a specific company by its ID. If the entry to be deleted is marked as a favorite, a new favorite is determined. If no phone has been marked as a favorite, an attempt is made to automatically determine the favorite based on the t
        • Perform an input validation without changing the data set or creating a company in the database (calculated fields are returned)
        • Perform an input validation without changing the data set or creating a company phone in the database
        • Add new e-mail addresses to an existing company. If the entry to be created is marked as a favorite, the previous favorite loses its status. If no mail has been marked as a favorite, an attempt is made to automatically determine the favorite based on the
        • Update existing e-mail addresses of a specific company by its ID. If the entry to be updated is marked as a favorite, the previous favorite loses its status. If no e-mail has been marked as a favorite, the first available element is selected
        • Delete an e-mail address form a specific company by its ID. If the entry to be deleted is marked as a favorite, a new favorite is determined. If no e-mail has been marked as a favorite, the first available element is selected
        • Checks if the index of the address quality service is working properly by creating, searching and deleting an index dummy entry.
        • Add and/or remove tags on several companies, with statistics
        • Start a tag job over many companies
        • Read the status of a tag job
        • Cancel a running tag job
        • List the tags of a selection of companies
      • Update an existing phone number of a specific company by its ID
      • Update an existing e-mail address of a specific company by its ID
    • Templates
      • E-Mail
        • Attachments
          • Uploads the provided attachment for the email template.
          • Deletes the attachment with the specified url for the email template.
          • Deletes all attachments for the email template.
        • Embedded images
          • Uploads the provided image for the email template.
          • Deletes the image with the specified url for the email template.
          • Deletes all images for the email template.
        • Processing
          • Does a preview of an email based on the provided subject, body and data.
          • Sends a test email based on the provided subject, body and data.
          • Sends a free email based on the provided subject, body and data. The emails are queued for sending, so `200 OK` means "accepted for delivery". If only some recipients could be queued the response is still `200 OK` and names the others in Cobra.EmailTempl
          • Sends a free email to all people in a list based on the provided subject, body and data. The emails are queued for sending, so `200 OK` means "accepted for delivery". If only some recipients could be queued the response is still `200 OK` and names the ot
        • Snippets
          • Retrieves email template snippets, optionally filtered by category.
        • Variables
          • Retrieves all available template variables.
        • Retrieves a single e-mail template by its identifier.
        • Updates an existing e-mail template.
        • Deletes an e-mail template by its identifier.
        • Creates a new e-mail template.
        • Deletes multiple e-mail templates.
        • Validates an e-mail template.
        • Marks one or more e-mail templates as favorite or removes the favorite flag.
        • Duplicates an existing e-mail template.
        • Updates the list of orga tags for an e-mail template.
        • Gets the tags of an e-mail template
        • Adds tags to an e-mail template
        • Removes tags from an e-mail template
        • Adds and/or removes tags across multiple e-mail templates (up to 250; larger selections use the tag job)
        • Changes visibility for one or more e-mail templates.
        • Updates organization tags for multiple e-mail templates.
        • Renders an e-mail template with the provided data.
        • Generates an e-mail template using AI based on the provided generation data.
        • Adds and/or removes tags across multiple e-mail templates, with statistics
        • Starts a tag job over many e-mail templates
        • Reads the status of a tag job
        • Cancels a running tag job
        • Lists the tags of a selection of e-mail templates
      • Settings
        • Orga tags (adhoc list)
          • Create one or more new orga tags.
          • Deletes a list of orga tags by their ids.
          • Deletes an existing orga tag by its id.
          • Substitutes an existing orga tag with a different one.
      • Word
        • Files
          • Uploads a DOCX template file and associates it with the specified word template.
          • Replaces the existing DOCX template file on the specified word template. If a file already exists it will be removed from storage before the new file is stored.
          • Removes the template file from the specified word template and deletes it from storage.
        • Rendering
          • Renders a word template with a given person's data context and returns the document.
          • Previews a word template as PDF as-is, keeping variable placeholders intact (no data substitution).
        • Variables
          • Retrieves all available document template variables.
        • Retrieves a single word template by its identifier.
        • Updates an existing word template.
        • Deletes a word template by its identifier.
        • Creates a new word template.
        • Deletes multiple word templates.
        • Validates a word template.
        • Marks one or more word templates as favorite or removes the favorite flag.
        • Duplicates an existing word template.
        • Updates the list of orga tags for a word template.
        • Gets the tags of a word template
        • Adds tags to a word template
        • Removes tags from a word template
        • Adds and/or removes tags across multiple word templates (up to 250; larger selections use the tag job)
        • Changes visibility for one or more word templates.
        • Updates organization tags for multiple word templates.
        • Adds and/or removes tags across multiple word templates, with statistics
        • Starts a tag job over many word templates
        • Reads the status of a tag job
        • Cancels a running tag job
        • Lists the tags of a selection of word templates
    • Lists
      • People
        • Members
          • Adds a single person to the People list
          • Adds multiple persons to the People list
          • Removes multiple persons from the People list
          • Removes a single person from the People list
        • Manual
          • Members
            • Adds a single person to the manual People list
            • Adds multiple persons to the manual People list
            • Removes multiple persons from the manual People list
            • Removes a single person from the manual People list
          • Gets a People List by its ID (any type).
          • Updates an existing manual People List by its ID
          • Deletes a manual People List by its ID
          • Creates a new manual People List
          • Duplicates an existing manual People List by its ID
          • Sets or clears the tenant-wide pin on a manual People List
          • Sets or clears a personal pin on a manual People List
          • Creates a new manual People List by evaluating a filter once and materializing the result.
        • FilterDynamic
          • Gets a People List by its ID (any type).
          • Deletes a live list by its ID.
          • Updates the name and/or description of a live list.
          • Creates a new live list with its initial version (version 1).
          • Duplicates an existing live list by its ID.
          • Replaces the filter criteria of a live list ("apply filter").
          • Activates an existing version of the live list.
          • Recreates the live list as a new manual List ("save as manual list").
          • Recreates the live list as a new static filter List ("save as static list").
          • Sets or clears the tenant-wide pin on a live list.
          • Sets or clears a personal pin on a live list.
        • FilterStatic
          • Gets a People List by its ID (any type).
          • Deletes a filter-based People List by its ID.
          • Updates the name and/or description of a filter-based People List.
          • Creates a new filter-based People List with its initial version (version 1).
          • Duplicates an existing filter-based People List by its ID.
          • Recreates the filter list as a new manual List ("save as manual list").
          • Computes a preview of a filter refresh without persisting a new version.
          • Creates and activates a new version as the result of a filter refresh.
          • Activates an existing version of the filter list.
          • Excludes and/or re-includes people at the active version of the filter list.
          • Sets or clears the tenant-wide pin on a filter list.
          • Sets or clears a personal pin on a filter list.
        • AiFilter
          • Generates a People filter from a description, or changes an existing one.
        • Filters
          • Previews the hit count of an arbitrary filter before any list exists for it.
        • Retrieves all members of a list with detailed information.
        • Deletes a People List by its ID
        • Duplicates an existing People List by its ID
        • Gets a People List by its ID
        • Updates an existing People List by its ID
        • Creates a new People List
        • Sets or clears the tenant-wide pin on a People List
        • Activates the predecessor version (undo of the last version change).
        • Sets or clears a personal pin on a People List
        • Gets the lists that use this list as a criterion or exclusion (any type).
  • cobra Event
    • Settings
      • Booking form field sets
        • Gets a field set for booking forms by its ID
        • Updates an existing field set for booking forms
        • Deletes an existing field set for booking forms
        • Creates a new field set for booking forms
        • Validates a field set for booking forms
        • Replaces all references to existing booking form field set by another set.
      • Cancellation conditions
        • Gets a cancellation condition by its ID
        • Updates an existing cancellation condition
        • Deletes an existing cancellation condition
        • Creates a new cancellation condition
        • Validates a cancellation condition
        • Replaces all references to existing cancellation condition by another condition.
      • Contact person templates (copy list)
        • Gets a contact person template by its ID
        • Updates an existing contact person template
        • Deletes an existing contact person template
        • Creates a new contact person template
        • Deletes a list of contact person templates
        • Validates a contact person template
      • Contributor roles (tenant list)
        • Gets a contributor role by its ID
        • Updates an existing contributor role
        • Deletes an existing contributor role
        • Creates a new contributor role
        • Deletes a list of contributor roles
        • Validates a contributor role
        • Replaces all references to existing contributor role by another contributor role.
      • Event categories (tenant list)
        • Gets an event category by its ID
        • Updates an existing event category
        • Deletes an existing event category
        • Creates a new event category
        • Deletes a list of event categories
        • Validates an event category
        • Replaces all references to existing event category by another event category.
      • Online meeting platforms (vendor list)
        • Gets a online meeting platform by its ID
      • Orga tags (adhoc list)
        • Gets an orga tag by its ID
        • Updates an existing orga tag
        • Deletes an existing orga tag
        • Gets an orga tag by its ID
        • Updates an existing orga tag
        • Deletes an existing orga tag
        • Creates a new orga tag
        • Creates a new orga tag
        • Deletes a list of orga tags
        • Deletes a list of orga tags
        • Validates an orga tag
        • Validates an orga tag
        • Replaces all references to existing orga tag by another orga tag.
        • Replaces all references to existing orga tag by another orga tag.
      • Tax rates (vendor list)
        • Gets a tax rate by its ID
      • Portal tags (tenant list)
        • Gets a portal tag by its ID
        • Updates an existing portal tag
        • Deletes an existing portal tag
        • Creates a new portal tag
        • Deletes a list of portal tags
        • Validates a portal tag
        • Replaces all references to existing portal tag by another portal tag.
      • Gets the event settings for the current tenant
      • Updates the event settings for the current tenant
      • Validates the event settings
    • Event files
      • Uploads the provided file for the event
      • Deletes the file with the specified url of an event
      • Deletes all files of an event
    • Event images
      • Uploads an image of a certain type for the event
      • Deletes the image with the specified url of an event
      • Deletes all images of an event
      • Updates the alternative text of an image
    • Contact person template images
      • Uploads an image for the contact person template.
      • Deletes the contact person template image.
      • Deletes a list of contact person template images.
    • Bookings
      • Creates a new booking (public)
        POST
      • Gets a booking by its ID
        GET
      • Gets the confirmation infos for a successful booking (public)
        GET
      • Deletes an existing booking
        DELETE
      • Deletes one or more bookings. Single delete is also handled by this endpoint by passing a list with one id.
        POST
      • Deletes a list of bookings
        DELETE
      • Calculates the current cancellation rules that apply when cancelling a booking including all tickets
        POST
      • Adds a participant to an event from the back-office, bypassing the registration deadline and with reduced validation
        POST
      • Cancels a booking and all belonging tickets
        POST
      • Cancels a booking and all belonging tickets
        POST
      • Calculates the current cancellation rules that apply when cancelling a booking including all tickets
        GET
      • Sets the booker information for a booking
        POST
      • Sends an invoice mail to the booker
        POST
      • Sets the invoice number of an external booking
        POST
      • Change the status of a payment
        POST
      • Collects the booking history statistics for an event
        POST
      • Collects the booking history actions for an event
        POST
      • Looks for data inconsistency in a booking and executes reparations.
        POST
      • Calculates what a cancellation of the selected tickets would do (refund, retained costs, remaining tickets), without changing anything. All amounts are in cent. `fullRefundOverride` requires the permission to cancel without condition.
        POST
      • Invoice bookings: confirms with a reference that the payout (paid invoice) or invoice correction of one cancellation operation was executed. A repeated confirmation with the same reference changes nothing.
        POST
    • 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, using filter criteria.
      • 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, using filter criteria.
      • Sets information data for the invited person
      • Imports invitations from a file
      • Send an filtered invitation free e-mail to a list of persons to invite
      • Generates a preview for a file import
      • Exports invitations for an event
      • Change the status of a list of participants
      • Adds the members of a CRM Cloud list to the invitation list of an event
      • Generates a preview for an import from a CRM Cloud list
      • Adds the persons of a file to the invitation list of an event
      • Generates a preview for an import from a file
      • Adds selected persons of the CRM Cloud to the invitation list of an event
      • Generates a preview for an import of selected persons of the CRM Cloud
    • 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 to a file
    • Website images
      • Uploads an image of a certain type for the website
      • Deletes the image with the specified url of a website
      • Deletes all images of a website
      • Updates the alternative text of an image
    • 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 an event by its ID (public)
      • Creates a new website
      • Gets a portal config by its url (public)
      • Deletes a list of websites
      • Validates a website
      • Validates a website
      • Validates a website name
      • 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 all field sets for booking forms that are used by an event (public), at most one per position (booking, participant)
    • _Root (Events)
      • 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
      • Exports events as CSV or XLSX file.
      • Reads an event's tags.
      • Adds tags to an event (incremental, idempotent union — existing tags are kept).
      • Replaces the whole set of tags of an event (tags not sent are removed).
      • Removes tags (by id) from an event.
      • Adds and/or removes tags on several events in one transaction (up to 250 events; larger selections use the tag job).
      • Reads an event's portal tags.
      • Adds portal tags to an event (incremental, idempotent union — existing tags are kept; catalog-only, text-only tags are rejected).
      • Replaces the whole set of portal tags of an event (tags not sent are removed; catalog-only, text-only tags are rejected).
      • Removes portal tags (by id) from an event.
      • Adds and/or removes tags on several events, with statistics (events changed, unchanged, missing; created and skipped tags; added/removed per tag).
      • Starts a tag job over many events (up to 100,000, in blocks of 250 in the background). Events that no longer exist are reported as missing.
      • Reads the status of a tag job (orga or portal tags).
      • Cancels a running orga-tag job: the block being processed finishes, the remaining blocks are skipped.
      • Adds and/or removes portal tags on several events in one transaction (up to 250 events; catalog-only, a text without id is rejected with 400).
      • Lists the distinct tags of a selection of events with the number of events carrying each, most used first.
      • Adds and/or removes portal tags on several events, with statistics (catalog-only, a text without id is rejected with 400).
      • Starts a portal-tag job over many events (up to 100,000, in blocks of 250 in the background; catalog-only, a text without id is rejected with 400). Poll it with GET tags/jobs/{id}.
      • Cancels a running portal-tag job: the block being processed finishes, the remaining blocks are skipped.
      • Lists the distinct portal tags of a selection of events with the number of events carrying each, most used first.
  • cobra Forms
    • Images
      • Uploads the header image for a form
      • Deletes the header image for a form
    • Responses
      • Gets a form response by its id
      • Deletes an existing form response
      • Deletes multiple existing form responses
      • Exports form responses as csv or xlsx stream
      • Add custom integration data to a form response
      • Returns true and a message to display if a threshold of free responses has been used
      • Returns the count of form responses for the current year.
      • Manually triggers Cobra Cloud integration for a form response
      • Manually re-triggers the fat client (cobra Classic) integration for a form response
    • Forms
      • Gets a form by its id
      • Patches fields for a form
      • Updates an existing form
      • Deletes an existing form
      • Creates a new form
      • Deletes a list of forms
      • Validates a form
      • Duplicates a form
      • Enables or disables the publication of a form
  • Tickets
    • Get a ticket by id
    • Update an existing ticket
    • Delete a ticket
    • Create a new ticket
    • Change ticket state (New, In Progress, Done)
  • Integrations
    • Webhooks
      • Get a list of all webhook subscriptions
      • Create a new webhook subscription
      • Get a webhook subscription by ID
      • Delete a webhook subscription
      • Change a webhook subscription
      • Lists all Webhook events which can be subscribed
    • EAP
      • Connectors
        • Get all available folders of a mailbox
        • Get all available categories of a mailbox
        • Get all available user with short and display name of cobra CRM
      • RuleActions
        • Get all actions of a rule
        • Create a new action for a rule
        • Delete an action by id
        • Delete all actions for the rule
      • RuleFilters
        • Get all filters of a rule which are used to filter emails before applying actions
        • Create a new filter for a rule
        • Delete all filters of a rule
      • Rules
        • Get all rules for the current user
        • Create a new rule for the current user
        • Get a rule by id
        • Modify an existing rule
        • Delete a rule by id
        • Delete multiple rules by their IDs
      • Runs
        • Run a specific rule for automated email processing
  • 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.
  • TenantInfoSubscription
    • /tenant-info/subscriptions/payment/urls/checkout
    • Gets the checkout URL for a payment.
    • /tenant-info/subscriptions/payment/urls/customer-portal
    • Gets the customer portal URL.
    • Increases the quantity of a payment.
    • Checks if a product exists in the current tenant's subscription.
    • Gets the active subscriptions for the current tenant.
  • TenantInfoV
    • /v2/tenant-info/tariff
  • Object Builder
    • CrmRelatedDetail
      • Gets the single record referencing the CRM entity through a one-to-one relationship plus the CRM related detail spec
      • Creates a new record referencing the CRM entity through a one-to-one relationship — the reference field is seeded server side, never by the client
      • Unlinks the record currently referencing the CRM entity — the record itself is not deleted, it becomes unassigned
    • Records
      • Creates a new record of the given object
      • Gets a page of records, sorted by creation date descending
      • Gets a single record by id
      • Replaces the complete data of an existing record (full replace)
      • Deletes a record
      • Uploads or replaces the image of an image field on a record
      • Deletes the image of an image field on a record
      • Adds one file to a file field on a record
      • Removes one file from a file field on a record
      • Downloads one file of a file field on a record
      • Invokes a workflow action bound to the object's default detail page on a record
      • Queries records with filters, sorting and paging
      • Deletes several records at once
    • RelatedRecords
      • Summarizes which objects hold records referencing the given CRM entity
      • Gets a page of records of one object referencing the given CRM entity
  • Schemas
    • AddTagsToCompaniesCommand
    • AbstractChannelDto
    • DeleteAllEmbeddedImagesResponse
    • AddressCoordinates
    • AddSubscriptionCommand
    • ActiveSubscriptionDto
    • AddUserCommand
    • ConfigResult
    • Appointment
    • BookingAction
    • BookingCancel
    • AppearanceConfigForCreate
    • ActionDefinitionAddCategory
    • AddIntegrationDataCommand
    • AddressGroupInputField
    • ActivateVersionInputDto
    • BooleanCobraApiResponse
    • AddressCoordinatesDto
    • AddTagsToTouchpointsCommand
    • DeleteAllEmbeddedImagesResponseCobraApiResponse
    • AddressType
    • Ai
    • ConfigResultCobraApiResponse
    • BookingFormFieldSetPublic
    • BookingActionListCobraApiResponse
    • BookingCancelInfo
    • AppearanceConfigForDetailed
    • ActionDefinitionAddContact
    • AddressGroupInputFieldOutput
    • AddPeopleListMemberDto
    • CrmRelatedDetailOutputDto
    • ChangeVisibilityEmailTemplateCommand
    • ChangeVisibilityWordTemplateCommand
    • AddressTypeDto
    • AiAnswerEmailGenerationDto
    • DeleteEmbeddedImageByUrlDto
    • AddressTypeForCreate
    • ModifySubscriptionCommand
    • Auth
    • DuplicateUserDto
    • IntrospectRequest
    • BookingFormFieldSetDetailed
    • BookingFormFieldSetPublicCobraApiResponse
    • BookingActionType
    • BookingCancelResult
    • ActionDefinitionAddTouchpoint
    • RunRuleCommand
    • AppearanceConfigInputDto
    • BulkAddPeopleListMembersResultDto
    • AiFilterForGenerateDto
    • AiTouchpoints
    • CrmRelatedDetailOutputDtoCobraApiResponse
    • AddressValidationInfoDto
    • BooleanNullableCobraApiResponse
    • DoubleCobraApiResponse
    • AiEmailGenerationAnswerDto
    • AddressTypeListCobraApiResponse
    • ObjectTypeForCreate
    • DuplicateUserDtoListCobraApiResponse
    • JsonDocumentCobraApiResponse
    • BookingFormFieldSetDetailedCobraApiResponse
    • BookingCancelResultCobraApiResponse
    • ActionDefinitionBase
    • AppearanceConfigOutputDto
    • BulkAddPeopleListMembersResultDtoCobraApiResponse
    • AiFilterResultDto
    • CrmRelatedDetailRecordInputDto
    • BatchTagsResultDtoCobraApiResponse
    • BookingFormFieldSetPublicListCobraApiResponse
    • CobraTagForEmbeddedDtoIEnumerableCobraApiResponse
    • AiMappingSuggestionRequestDto
    • DoubleNullableCobraApiResponse
    • AiEmailGenerationAnswerDtoCobraApiResponse
    • AddressValidationInfo
    • ObjectTypeForDetailed
    • Capabilities
    • EAP
    • BookingFormFieldSetDetailedValidationResult
    • CancellationConditionForDetailed
    • CancellationRule
    • BookingCancelInfoCobraApiResponse
    • BookingObjectForConfirmation
    • ColorConfig
    • ActionDefinitionMoveToFolder
    • BulkPeopleIdsDto
    • AiFilterResultDtoCobraApiResponse
    • InvokeActionResultDto
    • DeleteRecordsBulkResultDto
    • CobraTagForEmbeddedDto
    • AiMappingSuggestionResponseDto
    • AiEmailGenerationDto
    • AttendeeRole
    • EventPro
    • BookingFormFieldSetDetailedValidationResultCobraApiResponse
    • BookingObjectForConfirmationCobraApiResponse
    • ContentConfig
    • CobraFormInputDto
    • BulkRemovePeopleListMembersResultDto
    • BulkDeleteRulesCommand
    • CobraTagForEmbeddedDtoListCobraApiResponse
    • AiFilterWarningDto
    • Changefeed
    • InvokeActionResultDtoCobraApiResponse
    • DeleteRecordsBulkResultDtoCobraApiResponse
    • DeleteFileResponse
    • DeleteAllEmailTemplateAttachmentsResponse
    • AiMappingSuggestionResponseDtoCobraApiResponse
    • BatchProcess
    • AiEmailPeopleInvolvedDto
    • TicketForCreate
    • SubscriptionListCobraApiResponse
    • TokenRequest
    • BookingFormFieldSetForCreate
    • ContactPersonConfigForDetailed
    • BookingObjectForCreate
    • BookingObjectForDetailed
    • CobraFormInputDtoJsonPatchDocument
    • BulkRemovePeopleListMembersResultDtoCobraApiResponse
    • BulkDeleteRulesResponse
    • CreateFixedPeopleListCommand
    • InvokeRecordActionRequestDto
    • DeleteFileResponseCobraApiResponse
    • DeleteAllEmailTemplateAttachmentsResponseCobraApiResponse
    • BankAccountDetailForCreateDto
    • BatchProcessCobraApiResponse
    • AiNextBestActionCommand
    • TicketForDetailed
    • Webhook
    • UpdateUserCommand
    • TokenResponse
    • BookingObjectForDetailedCobraApiResponse
    • BookingObjectForPublicCreate
    • CobraFormInputDtoCobraFormOutputDtoUpdateEntityCommand
    • CobraFormInputDtoOperation
    • BulkDeleteRulesResponseCobraApiResponse
    • CreateFixedPeopleListInputDto
    • ConvertToFilterStaticListInputDto
    • DeleteAllEmailTemplateEmbeddedImagesResponse
    • BankAccountDetailForDetailedDto
    • AiNextBestActionOutputDto
    • TicketForDetailedCobraApiResponse
    • WebhookListCobraApiResponse
    • UpdateUserDto
    • TokenResponseCobraApiResponse
    • ContactPersonForDetailed
    • EmailConfig
    • BookingRepairOptions
    • BookingObjectPublic
    • DeletePortalImagesResponse
    • CreateRuleActionCommand
    • CobraFormInputDtoDeleteEntityCommand
    • CobraFormOutputDto
    • CreatePeopleListCommand
    • BatchTagsDto
    • CreateFixedPeopleListOutputDto
    • ConvertToManualListInputDto
    • CreateFilterStaticListCommand
    • Files
    • ObjectStatus
    • DeleteAllEmailTemplateEmbeddedImagesResponseCobraApiResponse
    • BankAccountDetailForPutDto
    • AiNextBestActionOutputDtoCobraApiResponse
    • WebhookSendMethod
    • UpdateUserSettingsCommand
    • CancellationConditionEmbedded
    • EventCalendar
    • BookingObjectPublicCobraApiResponse
    • DeletePortalImagesResponseCobraApiResponse
    • CreateRuleCommand
    • CobraFormInputDtoDeleteManyEntitiesCommand
    • CobraFormOutputDtoCobraApiResponse
    • EntityTagsResultDtoListCobraApiResponse
    • Flows
    • CreateFixedPeopleListOutputDtoCobraApiResponse
    • RecordFilterConditionDto
    • BatchTagsResultDto
    • AiSuggestTasksCommand
    • TouchpointReference
    • MarkAsFavoriteWordTemplateCommand
    • BusinessCard
    • Forms
    • LockoutReason
    • UserDto
    • CancellationConditionForCreate
    • CancelReason
    • BookingSelfCancelStatus
    • CreateRuleFilterCommand
    • ColorConfigInputDto
    • RecordInputDto
    • AiSuggestTasksOutputDto
    • BusinessCardCobraApiResponse
    • Integration
    • UserDtoCobraApiResponse
    • EventCategoryForDetailed
    • EventFileObject
    • CancellationInformationForCreate
    • CustomFieldAnswer
    • HeaderImageFocusScope
    • ColorConfigOutputDto
    • CrmSystemType
    • MicrotechErp
    • FilterType
    • RecordOutputDto
    • AiSuggestTasksOutputDtoCobraApiResponse
    • DeleteImageResponse
    • ObjectCobraApiResponse
    • ChangePriorityManyCommand
    • BusinessCardForCreate
    • UserRole
    • CancellationConditionForDetailedCobraApiResponse
    • CancellationInformationForDetailed
    • ExternalPaymentSettings
    • EmailSearchFields
    • ConsentField
    • ListType
    • Lists
    • MicrotechTickets
    • RecordOutputDtoCobraApiResponse
    • AiSuggestedTaskDto
    • DeleteImageResponseCobraApiResponse
    • ChannelVisibilityProperties
    • BusinessCardForPutCommand
    • UserRoleListCobraApiResponse
    • CancellationConditionForDetailedValidationResult
    • EventForDetailed
    • EventForDetailedCobraApiResponse
    • ChangeInvitationStatus
    • InvitationPublic
    • LegalNoticesConfig
    • HttpValidationProblemDetails
    • ConsentFieldOutput
    • MetaDataItemDto
    • CreateManualListFromFilterInputDto
    • RecordPageOutputDto
    • CallResultForCreateDto
    • CancellationOperation
    • EmailTemplateAttachmentDto
    • MetaDataItem
    • RenderWordTemplateRequestDto
    • BusinessCardForTouchpoints
    • UserSettingsDto
    • CancellationConditionForDetailedValidationResultCobraApiResponse
    • EventImageCollectionForDetailed
    • ChangePaymentStatus
    • InvitationPublicCobraApiResponse
    • ModifyRuleCommand
    • ConsentFieldProperties
    • DetailedListMemberDto
    • RecordPageOutputDtoCobraApiResponse
    • CallResultForDetailedDto
    • CallResultForDetailedDtoCobraApiResponse
    • CancellationPreview
    • ResponseMetaData
    • EmailTemplateByPromptDto
    • BusinessCardForTouchpointsCobraApiResponse
    • PaymentIncreaseQuantityCommand
    • UserSettingsDtoCobraApiResponse
    • EventImageObject
    • InvitationRejectionInput
    • ConsentFieldPropertiesOutput
    • FilterGroup
    • CrmListImportPreview
    • RecordQueryDto
    • CallResultForDetailedDtoListCobraApiResponse
    • CancellationPreviewCobraApiResponse
    • EmailTemplateDeleteByUrlDto
    • TemplateDataContextDto
    • CobraTagForEmbeddedDtoCobraApiResponse
    • DocumentDocumentDto
    • PaymentProviderType
    • EventImageType
    • CustomFieldAnswerForIntegration
    • InvitationStatus
    • PortalConfigForCreate
    • ProblemDetails
    • CountryInputFieldOutput
    • PeopleListDtoCobraApiResponse
    • BusinessCardIsActiveForUpdate
    • ObjectBuilder
    • PeopleListExclusionDto
    • FilterDynamicListForCreateDto
    • FilterRule
    • CrmListImportPreviewCobraApiResponse
    • RecordQueryScope
    • BusinessCardFromClipboard
    • CallResultForUpdateDto
    • CancellationPreviewRequest
    • EmailTemplateEmbeddedImageDto
    • TemplateVariableDto
    • EmailStatus
    • BusinessCardListCobraApiResponse
    • People360
    • EventLocationForDetailed
    • DailyBookingStats
    • InviteePublic
    • PortalConfigForDetailed
    • DateTimeFieldProperties
    • PeopleListMemberDto
    • CrmListImportRequest
    • RecordReferencedByDto
    • CurrencyFieldProperties
    • EmailTemplateForCreateDto
    • TemplateVariableDtoIReadOnlyCollectionCobraApiResponse
    • ColumnMappingDto
    • EmailStatusDataDto
    • BusinessCardValidationRequest
    • ContactPersonConfigForCreate
    • DailyBookingStatsListCobraApiResponse
    • PortalConfigForDetailedCobraApiResponse
    • RuleActionCaseType
    • DateTimeFieldPropertiesOutput
    • PeopleListMemberDtoCobraApiResponse
    • CrmListImportResult
    • FilterPreviewInputDto
    • RecordSortDto
    • CurrencyFieldPropertiesOutput
    • TemplateVisibilityKind
    • EmailTemplateForCreateDtoCobraApiResponse
    • CompanyAddressForCreateDto
    • EmbeddedImageDto
    • BusinessCardValidationResult
    • EventPaymentMethodSettingsForDetailed
    • DateSpanModel
    • PortalConfigForUpdate
    • RuleActionDto
    • DateTimeInputField
    • PreviewRefreshInputDto
    • CrmListImportResultCobraApiResponse
    • FilterPreviewPersonDto
    • ReferenceSnapshotInputDto
    • CurrencyInputField
    • EmailTemplateForDetailedDto
    • UpdateTagsForWordTemplatesCommand
    • CompanyAddressForDetailedDto
    • FormFieldBase
    • BusinessCardValidationResultCobraApiResponse
    • SubscriptionCobraApiResponse
    • ContactPersonForCreate
    • FormOfAddressType
    • Discount
    • OnlinePaymentInformation
    • PortalImageCollectionForCreate
    • RuleActionDtoCobraApiResponse
    • DateTimeInputFieldOutput
    • SetPinDto
    • PreviewRefreshResultDto
    • FilterPreviewResultDto
    • RelatedObjectCardinality
    • CurrencyInputFieldOutput
    • UploadFileResponse
    • EmailTemplateForDetailedDtoCobraApiResponse
    • CompanyAddressForDetailedDtoCobraApiResponse
    • CalendarAttendee
    • Tariff
    • GeoCoordinates
    • EmailAction
    • OnlinePaymentInformationPublic
    • PortalImageCollectionForDetailed
    • RuleDetailDto
    • UpdatePeopleListDto
    • PreviewRefreshResultDtoCobraApiResponse
    • ListOfDetailedListMembersDto
    • FilterPreviewResultDtoCobraApiResponse
    • RelatedObjectSummaryOutputDto
    • UploadFileResponseCobraApiResponse
    • EmailTemplateForDetailedDtoIEnumerableCobraApiResponse
    • CompanyAddressForDetailedDtoValidationResult
    • EventCancellationDto
    • CalendarEventListItemDto
    • Subscription
    • TariffCobraApiResponse
    • ContactPersonTemplateForCreate
    • EmailMessageStatus
    • ParticipationStatus
    • PortalImageObject
    • RuleDetailDtoCobraApiResponse
    • ListOfDetailedListMembersDtoCobraApiResponse
    • RelatedObjectSummaryOutputDtoListCobraApiResponse
    • EmailTemplateForDetailedDtoValidationResult
    • WordTemplateForCreateDto
    • CompanyAddressForDetailedDtoValidationResultCobraApiResponse
    • EventNoParticipationDto
    • CalendarEventResult
    • ContactPersonTemplateForDetailed
    • EventBooking
    • PaymentInformation
    • PortalImageType
    • RuleDto
    • DecimalInputField
    • FilterStaticListForCreateDto
    • EmailTemplateForDetailedDtoValidationResultCobraApiResponse
    • WordTemplateForDetailedDto
    • CompanyAddressForUpdateDto
    • EventParticipationDto
    • CalendarEventResultCobraApiResponse
    • TenantInfo
    • ContactPersonTemplateForDetailedCobraApiResponse
    • OnlineMeeting
    • EventBookingCobraApiResponse
    • PaymentInformationPublic
    • PortalTemplateType
    • RuleDtoCobraApiResponse
    • DecimalInputFieldOutput
    • RefreshVersionResultDtoCobraApiResponse
    • FilterTree
    • SortDirection
    • EmailTemplateRenderedDto
    • WordTemplateForDetailedDtoCobraApiResponse
    • CompanyDocumentForDetailedDto
    • EventRegistrationDto
    • TenantInfoCobraApiResponse
    • ContactPersonTemplateForDetailedValidationResult
    • OnlineMeetingPlatformForDetailed
    • PaymentMethod
    • EventInfo
    • PaymentItemInformationPublic
    • RuleDtoListCobraApiResponse
    • DecimalFieldProperties
    • EmailTemplateRenderedDtoCobraApiResponse
    • WordTemplateForDetailedDtoIEnumerableCobraApiResponse
    • CompanyForCreateDto
    • IconInfoDto
    • ContactPersonTemplateForDetailedValidationResultCobraApiResponse
    • PaymentStatus
    • RuleFilterCondition
    • DecimalFieldPropertiesOutput
    • TenantOrigin
    • Telephony
    • EmailTemplateSnippetCategory
    • WordTemplateForDetailedDtoValidationResult
    • CompanyForDetailedDto
    • Touchpoints
    • Contributor
    • PublicationConfigForDetailed
    • FilteredFreeMailData
    • PaymentType
    • RuleFilterDto
    • EmailInputField
    • Templates
    • EmailTemplateSnippetDto
    • WordTemplateForDetailedDtoValidationResultCobraApiResponse
    • CompanyForDetailedDtoCobraApiResponse
    • CompanyRelationType
    • Usermanagement
    • ContributorRoleEmbedded
    • RegistrationConfigForDetailed
    • RegistrationFormType
    • FreeMailData
    • ValidatePortalPublicationResponse
    • RuleFilterDtoCobraApiResponse
    • EmailInputFieldOutput
    • EmailTemplateSnippetDtoIReadOnlyCollectionCobraApiResponse
    • WordTemplateOutputFormat
    • CompanyForPutDto
    • CompanyRelationTypeForCreate
    • ContributorRoleForCreate
    • RegistrationPlatformType
    • IntegrationData
    • PersonPublic
    • ValidatePortalPublicationResponseCobraApiResponse
    • RuleFilterOperator
    • DeleteHeaderImageCommand
    • EmailNotificationConfigInputDto
    • EmbeddedCallResultDto
    • CompanyLogoForDetailedDto
    • IntegrationInitiatorDto
    • CompanyRelationTypeListCobraApiResponse
    • ContributorRoleForDetailed
    • RuleMailAddressMatching
    • EmailNotificationConfigOutputDto
    • UpdateNameDescriptionInputDto
    • CompanyMailDto
    • IntegrationInitiatorIconInfoDto
    • ConnectPersonToCompanyInput
    • ContributorRoleForDetailedCobraApiResponse
    • SalutationFormType
    • IntegrationDataDetailed
    • IntegrationDataDetailedCobraKeyValueData
    • TicketCancelInfo
    • PeopleListDto
    • CompanyMailForDetailDto
    • InternalCommunicationNoteDto
    • CopyList
    • ContributorRoleForDetailedValidationResult
    • UpdateVersionExclusionsInputDto
    • Ui
    • FreeEmailRecipientDto
    • CompanyNoteForCreateDto
    • CopyListForCreateDto
    • ContributorRoleForDetailedValidationResultCobraApiResponse
    • TaxRateForDetailed
    • InvitationDetailed
    • TicketPublic
    • FormResponseOutputDto
    • Int32NullableCobraApiResponse
    • CompanyNoteForDetailedDto
    • CopyListListCobraApiResponse
    • DeleteEventFilesResponse
    • TicketCategoryForDetailed
    • InvitationDetailedCobraApiResponse
    • FormResponseOutputDtoCobraApiResponse
    • UpdateVersionExclusionsResultDtoCobraApiResponse
    • FavoriteChannelsForUpdateDto
    • MarkAsFavoriteEmailTemplateCommand
    • CompanyNoteForDetailedDtoCobraApiResponse
    • CreateCalendarEventOptions
    • DeleteEventFilesResponseCobraApiResponse
    • InvitationDetailedListCobraApiResponse
    • ImageObjectOutputDto
    • FileUploadField
    • CompanyPhoneForCreateDto
    • Int64CobraApiResponse
    • CreateManyRelationsCommand
    • InvitationEmailOptions
    • ExportResponsesCommand
    • PeopleListUsageDto
    • FileUploadFieldOutput
    • CompanyPhoneForDetailedDto
    • InvitationFilter
    • IntegerFieldProperties
    • PeopleListUsagesDto
    • FileUploadFieldProperties
    • CompanyPhoneForDetailedDtoCobraApiResponse
    • MergeTouchpointsFromPersonCommand
    • InvitationForCreate
    • IntegerFieldPropertiesOutput
    • PeopleListUsagesDtoCobraApiResponse
    • FileUploadFieldPropertiesOutput
    • CompanyPhoneForDetailedDtoListCobraApiResponse
    • DeleteRelationsCommand
    • MessageEMailDto
    • FormElementBase
    • IntegerInputField
    • OrgaTagForCreateDto
    • OrgaTagForDetailedDtoListCobraApiResponse
    • CompanyPhoneForUpdateDto
    • EmailAddressType
    • EmailAddressTypeListCobraApiResponse
    • MessageLetterDto
    • DeleteImagesResponse
    • InviteeDetailed
    • FormElementBaseOutput
    • IntegerInputFieldOutput
    • InvitationImportPreview
    • OrgaTagForDetailedDto
    • PreviewEmailCommand
    • CompanyReferenceNumberForCreateDto
    • EmailAddressTypeForCreate
    • MessageLetterTemplateDto
    • EmbeddedAddressType
    • DeleteImagesResponseCobraApiResponse
    • InviteeForCreate
    • FormResponseOutputDtoDeleteManyEntitiesCommand
    • IntegrationDataDto
    • InvitationImportPreviewCobraApiResponse
    • CompanyReferenceNumberForDetailedDto
    • TouchpointForDetailedDto
    • EmbeddedAddressTypeForCreateAndUpdate
    • ManagedBookingForCreate
    • IntegrationDataDtoCobraKeyValueData
    • RefreshVersionInputDto
    • InvitationImportResult
    • RenderedEmailDto
    • MiscOtherDto
    • EmbeddedCompanyRelationTypeForInput
    • EmailInformation
    • RefreshVersionResultDto
    • InvitationImportResultCobraApiResponse
    • CompanyTagJobRequestDto
    • RenderedEmailDtoCobraApiResponse
    • EmbeddedCompanyRelationTypeForOutput
    • IntegrationTargetSystem
    • CompanyTagsInSelectionRequestDto
    • JsonNode
    • SendFreeEmailCommand
    • JsonNodeOptions
    • ObjectLinkForCreateDto
    • EmbeddedEmailAddressTypeForCreateAndUpdate
    • ParticipantsStatus
    • SendFreeEmailToListCommand
    • EmbeddedCompanyStatusForDetailDto
    • EmbeddedEmailAddressType
    • ObjectLinksDefinitionDto
    • EmbeddedListReference
    • IntegrationDataStatus
    • ParticipationInfoDetailed
    • LabelField
    • SendFreeEmailResultDto
    • UpdateFilterInputDto
    • ObjectLinksDto
    • EmbeddedPersonality
    • EventCategoryEmbedded
    • LabelFieldOutput
    • SendFreeEmailResultDtoCobraApiResponse
    • SendFreeEmailToListResultDtoCobraApiResponse
    • EmbeddedIndustrySectorInputDto
    • MeetingPersonalDto
    • EmbeddedPersonalityIEnumerableCobraApiResponse
    • EventCategoryForCreate
    • LegalNoticesConfigInputDto
    • SendTestEmailCommand
    • SendFreeEmailToListResultDto
    • EmbeddedIndustrySectorOutputDto
    • MeetingTeamsDto
    • PaymentItemInformation
    • LegalNoticesConfigOutputDto
    • EmbeddedLegalFormInputDto
    • MeetingZoomDto
    • EventCategoryForDetailedCobraApiResponse
    • LogoImageMode
    • UpdateVersionExclusionsResultDto
    • EntitySubstitute
    • EmbeddedLegalFormOutputDto
    • EventCategoryForDetailedValidationResult
    • ManualRefund
    • ValidationProblemDetails
    • EmbeddedLifecycleInputDto
    • PhoneConversationGuideCommand
    • ExportPeopleCommand
    • EventCategoryForDetailedValidationResultCobraApiResponse
    • PersonForCreate
    • MultipleSelectionField
    • EntityTagsResultDto
    • EmbeddedLifecycleOutputDto
    • FileStreamResultCobraApiResponse
    • PersonForDetailed
    • MultipleSelectionFieldOutput
    • Type
    • EmbeddedLifecycleOutputDtoCobraApiResponse
    • IRelationType
    • EventForCreate
    • PersonInfo
    • MultipleSelectionFieldProperties
    • IRelationTypeInput
    • UpdateTagsForEmailTemplatesCommand
    • EmbeddedNumberOfCustomersInputDto
    • Int64NullableCobraApiResponse
    • RemoveTagsFromTouchpointsCommand
    • QrCodeDataWrapper
    • MultipleSelectionFieldPropertiesOutput
    • IRelationTypeOutput
    • EmbeddedNumberOfCustomersOutputDto
    • IntegrationDataEntry
    • NameInputField
    • EmbeddedNumberOfEmployeesInputDto
    • MsTeamsCallDto
    • SendTouchpointAsEmailOptions
    • EventForDetailedValidationResult
    • SendFilteredMailResponse
    • NameInputFieldOutput
    • PeopleSelectionImportRequest
    • UploadImageResponse
    • EmbeddedNumberOfEmployeesOutputDto
    • IntegrationDataEntryDtoCobraApiResponse
    • EventForDetailedValidationResultCobraApiResponse
    • SendFilteredMailResponseCobraApiResponse
    • UploadImageResponseCobraApiResponse
    • EmbeddedReferenceNumberTypeInputDto
    • StringCobraKeyValueData
    • Lifecycle
    • EventImageCollectionForCreate
    • SetInvoiceNumber
    • PhoneInputField
    • TagWriteEntityStatus
    • EmbeddedReferenceNumberTypeOutputDto
    • IntegrationDataEntryDto
    • LifecycleCobraApiResponse
    • StringListCobraApiResponse
    • PhoneInputFieldOutput
    • EmbeddedRelationManagedByPeopleRoleForDetailDto
    • LifecycleForCreate
    • TaxRateInfoDetailed
    • RatingField
    • PersonSelection
    • EmbeddedSocialMediaForCreateDto
    • LifecycleForUpdate
    • RatingFieldOutput
    • EmbeddedSocialMediaForDetailedDto
    • RecommendationDto
    • TouchpointAnalysisMetadataDto
    • LifecycleListCobraApiResponse
    • EventLocationForCreate
    • PatchEntityCommand
    • RatingFieldProperties
    • RejectedInvitee
    • TemplateTagJobRequestDto
    • TouchpointFileDto
    • ManagerRole
    • RatingFieldPropertiesOutput
    • TemplateTagsInSelectionRequestDto
    • PeopleInvolvedDto
    • TouchpointForCreateDto
    • ManagerRoleForCreate
    • EventNoteForCreate
    • TouchpointForCreateDtoCobraApiResponse
    • ManagerRoleListCobraApiResponse
    • EventNoteForDetailed
    • TicketInfo
    • PublishFormCommand
    • SalutationFieldPropertiesOutput
    • ExcelUploadResultDto
    • EventNoteForDetailedCobraApiResponse
    • TicketList
    • SalutationGroupInputField
    • ExcelUploadResultDtoCobraApiResponse
    • TouchpointForDetailedDtoCobraApiResponse
    • EventPaymentMethodSettingsForCreate
    • TicketValidated
    • SalutationGroupInputFieldOutput
    • ExecuteImportRequestDto
    • TouchpointForDetailedDtoValidationResult
    • OrgaTag
    • TicketValidatedCobraApiResponse
    • SalutationInputFieldOutput
    • RemainingTicket
    • ExecuteImportResponseDto
    • TouchpointForDetailedDtoValidationResultCobraApiResponse
    • EventPortalForCreate
    • SelectionFieldItem
    • ExecuteImportResponseDtoCobraApiResponse
    • TouchpointNoteDto
    • OrgaTagListCobraApiResponse
    • EventPortalForDetailed
    • SelectionFieldItemOutput
    • TouchpointSettingsInputDto
    • PagedCalendarEvents
    • EventReminderSettingsForCreate
    • SingleSelectionField
    • ImportJobStatusDto
    • TouchpointStatusDataDto
    • OrgaTagForCreate
    • PagedCalendarEventsCobraApiResponse
    • EventReminderSettingsForDetailed
    • SingleSelectionFieldOutput
    • ImportFieldErrorDto
    • ImportJobStatusDtoCobraApiResponse
    • EventSettingsForCreate
    • SingleSelectionFieldProperties
    • ImportPreviewRequestDto
    • People
    • EventSettingsForDetailed
    • SingleSelectionFieldPropertiesOutput
    • ImportPreviewResponseDto
    • ParseClipboardTextCommand
    • PeopleAddress
    • EventSettingsForDetailedCobraApiResponse
    • Spacer
    • ImportPreviewResponseDtoCobraApiResponse
    • PeopleAddressCobraApiResponse
    • EventSettingsForDetailedValidationResult
    • SpacerOutput
    • PeopleAddressForCreate
    • EventSettingsForDetailedValidationResultCobraApiResponse
    • SpacerProperties
    • ImportPreviewRowDto
    • ImportResultDto
    • UpdateTouchpointAnalysisDto
    • PeopleAddressForUpdate
    • EventStatus
    • SpacerPropertiesOutput
    • WebformWebformDto
    • PeopleBirthdayDto
    • ExportEventsCommand
    • TextAreaInputField
    • ImportRowErrorDto
    • ImportStatus
    • PeopleBusinessPosition
    • FooterInformation
    • TextAreaInputFieldOutput
    • IndustrySectorForCreateDto
    • TelephoneCallDto
    • PeopleCobraApiResponse
    • TextFieldProperties
    • EventTagJobRequestDto
    • IndustrySectorForDetailedDto
    • TouchpointAnalysisDto
    • PeopleEmail
    • TextFieldPropertiesEx
    • EventTagsInSelectionRequestDto
    • IndustrySectorForDetailedDtoCobraApiResponse
    • PeopleEmailForCreateAndUpdate
    • TextFieldPropertiesExOuptut
    • TextFieldPropertiesOutput
    • PeopleForCreateDto
    • PeopleForFilter
    • TextInputField
    • PeopleForFilterListCobraApiResponse
    • TextInputFieldOutput
    • TitleField
    • PeopleForCreateFromClipboardDto
    • LegalFormForCreateDto
    • PeopleForUpdateDto
    • PeopleIEnumerableCobraApiResponse
    • OnlineMeetingPlatformEmbedded
    • TitleFieldOutput
    • PeopleForCreateFromClipboardDtoCobraApiResponse
    • LegalFormForDetailedDto
    • PeopleImage
    • TouchpointTagJobRequestDto
    • TouchpointSettingsOutputDto
    • LegalFormForDetailedDtoCobraApiResponse
    • PeopleImageCobraApiResponse
    • OnlineMeetingPlatformForDetailedCobraApiResponse
    • TouchpointTagsInSelectionRequestDto
    • TouchpointSettingsOutputDtoCobraApiResponse
    • LifecycleForCreateDto
    • UrlInputField
    • LifecycleForDetailedDto
    • PeopleImportantDate
    • PeopleLifecycleForInput
    • OrgaTagForDetailed
    • UrlInputFieldOutput
    • LifecycleForDetailedDtoCobraApiResponse
    • PeopleLifecycleForOutput
    • OrgaTagForDetailedCobraApiResponse
    • LifecycleForUpdateDto
    • PeopleLifecycleForOutputCobraApiResponse
    • OrgaTagForDetailedValidationResult
    • ManagedByPersonRelationForCreateDto
    • PeopleList
    • OrgaTagForDetailedValidationResultCobraApiResponse
    • ManagedByPersonRelationForDetailDto
    • PeopleListListCobraApiResponse
    • PortalTagForCreate
    • UpdateHeaderImageCommand
    • ManagedByPersonRelationForDetailDtoCobraApiResponse
    • PeopleMerged
    • PortalTagForDetailed
    • ManagedByPersonRelationForDetailDtoListCobraApiResponse
    • TurnoverBillDto
    • PeopleNote
    • PortalTagForDetailedCobraApiResponse
    • TurnoverDialogMarketingDto
    • PeopleNoteCobraApiResponse
    • PortalTagForDetailedValidationResult
    • NumberOfCustomersForCreateDto
    • TurnoverEventBookingDto
    • PeopleNoteForCreateDto
    • PortalTagForDetailedValidationResultCobraApiResponse
    • NumberOfCustomersForDetailedDto
    • TurnoverOfflineDto
    • PeoplePhone
    • PublicationConfigForCreate
    • NumberOfCustomersForDetailedDtoCobraApiResponse
    • TurnoverShopDto
    • PeopleQuickLook
    • NumberOfEmployeesForCreateDto
    • PeopleQuickLookCobraApiResponse
    • PublicationConfigForDetailedCobraApiResponse
    • NumberOfEmployeesForDetailedDto
    • PeopleSocialMedia
    • RegistrationConfigForCreate
    • NumberOfEmployeesForDetailedDtoCobraApiResponse
    • PeopleValidationResult
    • PeopleValidationResultCobraApiResponse
    • PeopleWithResponsibleForObjects
    • OrgaTagForDetailDto
    • PeopleWithResponsibleForObjectsCobraApiResponse
    • OrgaTagForDetailDtoListCobraApiResponse
    • Personality
    • PeopleSelectionDto
    • PreviewFieldErrorDto
    • PersonalityForCreate
    • ReferenceNumberTypeForCreateDto
    • PersonalityListCobraApiResponse
    • SimpleEntityIdData
    • PeopleTagJobRequestDto
    • ReferenceNumberTypeForDetailedDto
    • PeopleTagsInSelectionRequestDto
    • ReferenceNumberTypeForDetailedDtoCobraApiResponse
    • Relation
    • RelationCobraApiResponse
    • TaxInformationForCreate
    • TaxInformationForDetailed
    • ReferenceNumberTypeForUpdateDto
    • RelationForDeleteDto
    • RelationForDelete
    • RelationForDetailedDto
    • TaxRateForDetailedCobraApiResponse
    • RelationForDetailedDtoCobraApiResponse
    • RelationForManyCreateInputDto
    • TaxRateForEmbeded
    • RelationForDetailedDtoListCobraApiResponse
    • RelationForUpdate
    • RelationForValidateRequest
    • TicketCategoryForCreate
    • RelationForSingleUpdateDto
    • RelationForValidateWithPeopleIdRequest
    • RelationForUpdateItem
    • RelationForUpdateDto
    • RelationListCobraApiResponse
    • TagJobDtoCobraApiResponse
    • RelationManagedByPeopleRoleForCreateDto
    • RelationValidationResult
    • RelationForCreateDto
    • RelationManagedByPeopleRoleForDetailedDto
    • RelationValidationResultCobraApiResponse
    • RelationManagedByPeopleRoleForDetailedDtoCobraApiResponse
    • RelationTypeCustomPropertyDto
    • ValidateEventPublicationResponse
    • TagsInSelectionDtoCobraApiResponse
    • RelationTypeForCreateDto
    • ResponsibleFor
    • ValidateEventPublicationResponseCobraApiResponse
    • RelationTypeForDetailedDto
    • RelationTypeForDetailedDtoCobraApiResponse
    • SettingsForCreate
    • StringCobraApiResponse
    • RemoveTagsFromCompaniesCommand
    • StringIntegrationDataEntryDtoDictionaryCobraApiResponse
    • UpdateCalendarEventOptions
    • UploadImageResponseDto
    • RemoveTagsDto
    • SettingsForCreateDto
    • UploadImageResponseDtoCobraApiResponse
    • SetIntegrationDataInputDto
    • ValidateCompanyPhoneCommand
    • TagBatchStatisticsDto
    • TagBatchTagStatisticDto
    • TagJobDto
    • TagUsageDto
    • TagsInSelectionDto
    • UpdateRelationsCommand
  1. Bookings

Calculates what a cancellation of the selected tickets would do (refund, retained costs, remaining tickets), without changing anything. All amounts are in cent. `fullRefundOverride` requires the permission to cancel without condition.

POST
https://api.cobra.de/v1/events/bookings/{id}/cancellation-preview
Last modified:2026-11-03 09:05:30

Request

Path Params

Header Params

Body Params
application/json

Example
{
    "ticketIds": [
        "string"
    ],
    "fullRefundOverride": true
}

Request Code 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 'https://api.cobra.de/v1/events/bookings//cancellation-preview' \
--header 'X-Integration-Name: API Documentation' \
--header 'X-Integration-Provider: cobra GmbH' \
--header 'X-Cobra-TenantId: 12e39e53-ece1-4d8d-8958-e782de1dbef0' \
--header 'X-Integration-Contact: info@cobra.de' \
--header 'Accept-Language: de' \
--header 'Content-Type: application/json' \
--data '{
    "ticketIds": [
        "string"
    ],
    "fullRefundOverride": true
}'

Responses

🟢200
application/json
OK
Bodyapplication/json

Example
{
    "data": {
        "lines": [
            {
                "ticketId": "string",
                "eventName": "string",
                "ticketName": "string",
                "currency": "string",
                "actualPrice": 0,
                "cancelDateTime": "2019-08-24T14:15:22.123Z",
                "daysToEventStart": 0,
                "percent": 0,
                "refundedPart": 0,
                "nonRefundedPart": 0,
                "fixedCosts": 0,
                "refundedAmount": 0
            }
        ],
        "refundAmount": 0,
        "fixedCosts": 0,
        "remainingTickets": [
            {
                "ticketId": "string",
                "name": "string"
            }
        ],
        "paymentState": "string",
        "blockedReason": "string",
        "previewVersion": "string"
    },
    "message": "string",
    "metaData": {
        "totalResults": 0,
        "responseTimeStamp": "2019-08-24T14:15:22.123Z"
    },
    "statusCode": 0
}
🟠400
🟠403
🟠404
Modified at 2026-11-03 09:05:30
Previous
Looks for data inconsistency in a booking and executes reparations.
Next
Invoice bookings: confirms with a reference that the payout (paid invoice) or invoice correction of one cancellation operation was executed. A repeated confirmation with the same reference changes nothing.
Built with