NEnetter
integrations

Create Integration

Changed on

Register or update an integration for the company (upsert by provider).

Handles three paths:

  • Custom credentials: credentials dict provided → validate, test, encrypt.
  • Neither: mark disconnected.

Per-resource permissions: any company member may CREATE a new integration (they're auto-granted ADMIN on it); updating an existing (company, provider) row in place requires EDITOR on that integration.

post/api/v1/integrations/

Request

  • Base URL
    https://api.netter.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.netter.ai/api/v1/integrations/
  • Auth
    none declared

Request body

provider_idstring uuid required
credentialsobject nullable

Response

Successful Response

idstring uuid required
company_idstring uuid required
user_idstring uuid required
provider_idstring uuid required
statusstring required
has_credentialsboolean
connected_atstring date-time nullable required
created_atstring date-time required

Changes

  • 3b9d2a5b4228Revision changes
    • breaking

      removed the required property from the response with the status

    • warning

      removed the request property