Changelog
DiscussionsChangelog
Back to All
Improved

Developer Portal documentation accuracy improvements

August 11th, 2026 by Mike Rohweder

We’ve refreshed the Demandbase Developer Portal to make Export API, B2B API, and Import API integrations easier to implement from the published documentation and examples.

Documentation update: These improvements clarify existing API behavior; they do not change the APIs themselves.

Export API

  • Corrected supported filter fields, operator names, activity-date guidance, copyable JSON, and job examples in the Export filter guide.
  • Corrected the case-sensitive Account List and Person List routes: /accountList/job and /personList/job.
  • Documented all Export job states in the job-status reference: non-terminal accepted and processing; terminal finished and failed.
  • Clarified that the Export API server root is https://uapi.demandbase.com/data/export, with versions included in operation paths such as /v1/fields.
  • Repaired the rate-limits link in the Export API FAQ.
  • Added the complete asynchronous workflow to the Export API Overview: submit a job, poll its status to a terminal state, and download the generated result file or files.

B2B API

  • Repaired the bearer-authentication link throughout the generated API reference. It now points to the canonical access-token reference.
  • Corrected the company-fetch field value from familyTree to the supported familytree casing in the B2B API FAQ.
  • Corrected four routes in the Credit Consumption Model: /contacts, /companies, /company/{companyId}/newsFeed, and /company/{companyId}/news?newsCategories=.
  • Documented the complete webhook verification lifecycle in the webhook configuration guide: VERIFICATION_PENDING, VERIFICATION_RUNNING, followed by ACTIVE or DISABLED.
  • Added those four webhook status values to the WebhookDTO.status OpenAPI enum in the subscription-details reference.
  • Corrected the access-token lifetime example to 28,800 seconds (eight hours) in the access-token reference.
  • Repaired two customer-facing links in Make Your First Request by removing editor-only /update/ paths.
  • Aligned the webhook configuration guide with the emitted payload: alertId is a string and date uses ISO-8601 local date-time format.
  • Replaced 56 retired Stoplight link occurrences in the IV API to B2B API Migration guide with canonical Developer Portal references.

Export API error handling

  • Added declared error responses, including 429 Too Many Requests, across Export API reference operations.
  • Published the Export error catalog with HTTP statuses, stable error codes, and guidance for using diagnosticCode when troubleshooting.

Import API

  • Corrected published daily limits and route names in Rate Limits, including underscore routes and /{entityType}/sources.
  • Repaired the Import Available Endpoints links and replaced retired legacy portal URLs with canonical Developer Portal references.
  • Updated Importing Intent Activities to use the public activityTypeId request field, raw binary application/octet-stream uploads, and entityType: intent_activity; the Import API reference now also lists intent_activity in the applicable entity-type descriptions.

These updates remove several sources of ambiguity around case-sensitive routes, accepted values, asynchronous states, error handling, authentication, token lifetime, webhook payloads, migration paths, rate limits, and copyable request examples.