IDB2B API icon

IDB2B API

AI Agents that turn conversations into customers for WhatsApp, Instagram & TikTok

Activity → Create

AI-generated

Summary

Create an activity linked to either a specific company or contact in the IDB2B system.

Inputs

  • Subject (required) — Subject of the activity, required.
  • Associate With (required) — Choose whether to associate the activity with a company or a contact.
  • Company ID (required) — ID of the company to associate this activity with (required if associating with a company).
  • Contact ID (required) — ID of the contact to associate this activity with (required if associating with a contact).
  • Additional Fields — Optional additional details to include with the activity such as description, date and time (ISO 8601 format), icon identifier, and UUID of the user associated with the activity.

Output shape

a single JSON record containing details of the created activity or a success message if data is not returned by the server

If the server does not return the created entity, the output includes the submitted data annotated with a note that ID and timestamps are unavailable. The API call uses a POST request with form data payload. Errors during creation produce detailed error messages.

Examples

Example 1: Create an activity associated with a company

Specify the subject, select 'Company' for association, and provide the company ID.

Example 2: Create an activity associated with a contact with additional details

Provide the subject, choose 'Contact' as association, supply the contact ID, and optionally fill additional fields like description and datetime.

Links

Discussion