latestOpenAPI 3.0.12026-08-20112309904.6 KB

466169815b78

Suppliers - Connection Contacts

Create connection contact for a supplier by identifier

Overview

Create a new connection contact for a supplier identified by any of its identifiers (supplierId, customerId, ownId, or prewaveId).

This endpoint allows you to add contact persons to suppliers for relationship management. If your organization is not yet connected to the identified target, it will be automatically connected as a supplier.

Auto-Connection Logic

  • If the identified target is not yet connected to your organization, an edge of type 'Supplier' will be created automatically.
  • This requires the additional internal permission access_public_mng_customer_conn.

Related Operations

  • List Contacts: GET /public/v2/suppliers/connection-contacts
  • Delete Contact: DELETE /public/v2/suppliers/connection-contacts/{contactId}

Required Permission

access_public_suppliers and access_public_mng_conn_contacts

post/public/v2/suppliers/connection-contacts

Query parameters

supplierIdstring

Supplier ID to search for. Can be combined with customerId, ownId, and/or prewaveId.

customerIdstring

Customer ID to search for. Can be combined with supplierId, ownId, and/or prewaveId.

ownIdstring

Own site ID to search for. Can be combined with supplierId, customerId, and/or prewaveId.

prewaveIdinteger

Prewave ID to search for. Can be combined with supplierId, customerId, and/or ownId.

sourcestring

Optional source system to filter by. If not provided, matches IDs with any source or without a source. Applies to all provided ID parameters.

Request body

emailstring email required

Email address of the connection contact.

Example request

{
  "email": "contact@example.com"
}

Response

Connection contact created successfully

idinteger required

Unique identifier of the connection contact.

emailstring email nullable

Email address of the connection contact. May be null if not provided.

Example response

{
  "id": 42,
  "email": "contact@example.com"
}