Skip to content

Create contacts

Contacts in tebio represent natural persons who are assigned to a customer profile. They are used to manage contact persons within a customer profile and to specifically control communication with customers.

Especially with business customers (BUSINESS, B2B), the customer is often a company with multiple contacts. You use contacts to define specific contact persons within this organization:

  • a different invoice recipient, for example the head of the accounting department.
  • a specific recipient for physical deliveries to a branch.
  • administrative or technical contact for helpdesk processes.
  • You are logged in to the tebio business portal.
  • You have opened the detailed view of the customer for whom the contact is to be added.

In tebio you have two ways to create new contacts.

If you would like to create multiple contacts for a company in a structured manner, use the central contact management:

  1. Open the customer’s detailed view.
  2. Click on the three-dot menu (…) at the top right of the Helpdesk tab.
  3. Select Contacts in the dropdown.
  4. A tabular overview of the existing contact persons for this customer opens.
  5. Click Create.

Way 2: Create a contact directly in the address management

Section titled “Way 2: Create a contact directly in the address management”

If you create a billing or delivery address and the recipient does not yet exist as a contact, you can create the contact directly in the address management:

  1. Navigate to the Addresses tab in the customer profile.
  2. Create or edit an address.
  3. In the recipient area, select the Create new contact option.

Depending on the path chosen, the scope of the form differs:

Variant A: Complete form in the central contact management

Section titled “Variant A: Complete form in the central contact management”
  1. Enter the person’s basic information, such as first name, last name, email address and telephone number.
  2. Role: This field is mandatory. Select the person’s functional area of ​​responsibility, for example finance, technical, administration, support or administrator.
    • If this person is primarily responsible for billing issues, the Finance role is recommended.
  3. Position: Optionally select the person’s hierarchical or professional position in the company, for example management, purchasing or employee.
  4. Preferred Language: Set the language in which automatic messages should be sent to this contact.
  5. Default Contact: Enable the switch if you want this person to be the primary contact for this customer.
  6. Click Save.

Variant B: Simplified form in address management

Section titled “Variant B: Simplified form in address management”

If the contact is created directly in the address management, the form is reduced to the most important information:

  1. Enter the name details, for example first name and last name. Optionally, you can add company name, title and email address.
  2. Fields such as role, position or preferred language are omitted in this variant.
  3. Click Save Changes.

The contact created is now linked to the customer profile. It is then displayed in selection fields for recipients, for example for addresses or when sending documents.

  • Default Contact: It is recommended to set at least one default contact for each customer profile. For private customers (PRIVATE, B2C) this can be the customer themselves.
  • Role definition: Ensure consistent maintenance of the role, for example Finance, as automatic processes can control messages or documents based on this role.

Contacts are managed in the API via their own endpoints and linked to a customer:

End pointMethodDescriptionOperationId
/v1/customer/contactPOSTCreate a contact for a customercreateCustomerContact
/v1/customer/contact/{uuid}GETRetrieve contactgetCustomerContact
/v1/customer/contact/{uuid}PUT / PATCHUpdate contact informationupdateCustomerContact
/v1/customer/contactGETSearch or list contactssearchCustomerContact

Note: Customer contacts are contact persons for a customer. Company contacts in the company data are contact persons for your own company.