tenant

Submit / activate this tenant's Odoo connection.

post/api/v1/tenant/odoo-connection

Request

  • Base URL: https://api.prosp.cc
  • URL: https://api.prosp.cc/api/v1/tenant/odoo-connection
  • Auth: OAuth 2 (client credentials, token URL https://prosp-mcp-641053169627.auth.eu-central-1.amazoncognito.com/oauth2/token, scopes: mcp/execute)

Request body

odoo_urlstring required

Public https base URL of the tenant's Odoo instance.

odoo_dbstring required

Your Odoo database name — one of the four API authentication parameters (alongside odoo_url, odoo_uid, odoo_api_key). An Odoo server can host multiple databases, so this identifies which one to sync leads into. Leads are written through Odoo's JSON-RPC API — no direct database access is used. If unsure, find it at https://<your-odoo-host>/web/database/list.

odoo_uidinteger required

The Odoo user id the API key belongs to.

odoo_api_keystring required

Odoo API key used to authenticate. Write-only — accepted here but never returned on any response.

stage_idinteger

Optional Odoo CRM stage id to place new leads in. Validated to exist before the connection is saved.

team_idinteger

Optional Odoo sales-team id to assign new leads to. Validated to exist before the connection is saved.

user_idinteger

Optional Odoo user id to assign as the salesperson on new leads. Validated to exist before the connection is saved.

enrichment_stage_idinteger

Optional Odoo CRM stage id for leads awaiting further contact enrichment. Validated to exist before the connection is saved.

lead_type'lead' | 'opportunity'

Whether new records are created as CRM leads or opportunities. Defaults to opportunity when omitted.

Example request

{
  "odoo_url": "https://mycompany.odoo.com",
  "odoo_db": "mycompany-main-12345",
  "lead_type": "opportunity"
}

Response

Connection re-validated and updated (a connection already existed).

customer_idstring required

Your tenant identifier (derived from the access token).

odoo_urlstring required

The Odoo base URL leads are written to.

odoo_dbstring required

Your Odoo database name — the API authentication parameter identifying which database on the Odoo server leads are synced into. Leads are written through Odoo's JSON-RPC API; no direct database access is used.

odoo_uidinteger required

The Odoo user id the stored API key belongs to.

statusstring required

Connection status (e.g. active).

stage_idinteger nullable

The configured Odoo CRM stage id for new leads, or null if unset.

team_idinteger nullable

The configured Odoo sales-team id for new leads, or null if unset.

user_idinteger nullable

The configured Odoo salesperson user id for new leads, or null if unset.

enrichment_stage_idinteger nullable

The configured Odoo CRM stage id for leads awaiting enrichment, or null if unset.

lead_type'lead' | 'opportunity'

Whether records are created as leads or opportunities.

validated_atstring date-time

When the connection was last successfully validated (present only on a submit response).

messagestring

Human-readable outcome of the submit (present only on a submit response).

Example response

{
  "odoo_url": "https://mycompany.odoo.com",
  "status": "active",
  "lead_type": "opportunity"
}

Changes

No recorded changes to this operation across all 1 revision of this API.