Integrations

Start Migration Discovery

Look at what is in the CRM. WRITES NOTHING to graph8.

Counts records, reads the field and pipeline shape, and proposes mappings. Poll GET /integrations/migrations/{migration_id} for the result, then accept it with /confirm.

Org admin, matching the app.

post/integrations/migrations/discovery

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/integrations/migrations/discovery
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

connection_idstring required
crm_typestring

Which CRM. The app's default is hubspot.

Response

Successful Response

dataConnectionPayload required

An open envelope for a connection, a token or a migration report.

Open because the migration STATUS payload carries a per-entity progress map, a discovered-field map and a pipeline list that all grow with the providers - and because a dropped warning on a migration report reads as "nothing went wrong".

Changes

No recorded changes to this operation across all 2 revisions of this API.