API Documentation Propulxia

1. Authentication

All requests to the API require an API key passed in the Authorization HTTP request header:

Authorization: Bearer plx_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

2. Conventions

• Identifiers (id) are opaque string structures.
• Amounts are expressed in the main currency unit (e.g. 1500.00 for $1500.00).
• Dates (createdAt, etc.) are Unix timestamps in milliseconds.
• Any error returns a body format {"error": "message"} with the corresponding HTTP code.

3. Proposals

curl https://app.propulxia.com/api/v1/proposals?status=sent&limit=10 \
  -H "Authorization: Bearer plx_live_..."

{
  "proposals": [
    {
      "id": "abc123",
      "title": "Refonte site web — Acme inc.",
      "status": "sent",
      "clientId": "cl_789",
      "companyId": "co_456",
      "totalAmount": 4500,
      "currency": "CAD",
      "shareUrl": "https://app.propulxia.com/share/a1b2c3...",
      "createdAt": 1737331200000
    }
  ]
}

curl -X POST https://app.propulxia.com/api/v1/proposals \
  -H "Authorization: Bearer plx_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Refonte site web",
    "clientId": "cl_789",
    "companyId": "co_456",
    "totalAmount": 4500,
    "currency": "CAD"
  }'

curl -X POST https://app.propulxia.com/api/v1/proposals/abc123/send \
  -H "Authorization: Bearer plx_live_..." \
  -H "Content-Type: application/json" \
  -d '{"to": "client@example.com"}'

4. Clients

Manage your sales clients (contacts within your target companies) via these endpoints:

5. Tasks

Manage follow-up and reminder tasks associated with your proposals and prospects:

curl -X POST https://app.propulxia.com/api/v1/tasks \
  -H "Authorization: Bearer plx_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Relancer le client Acme",
    "dueDate": 1793240537850,
    "proposalId": "abc123",
    "status": "todo"
  }'

6. Templates

Retrieve in read-only mode the structured proposal templates built in your account:

7. Products Catalog

Synchronize your item library or pricing grids with your invoicing tools:

8. Employees (Team)

Manage team member accounts for your sales organization:

9. Reporting

{
  "totalProposals": 42,
  "byStatus": { "backlog": 5, "in_progress": 3, "sent": 10, "won": 20, "lost": 4 },
  "totalValue": 187500,
  "wonValue": 92000,
  "winRate": 0.8333
}

10. Webhooks

Subscribe a HTTPS URL to receive real-time notifications.

curl -X POST https://app.propulxia.com/api/v1/webhooks \
  -H "Authorization: Bearer plx_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://votre-service.com/webhooks/propulxia",
    "events": ["proposal.sent", "proposal.paid"]
  }'

11. Integrations (Zapier)

Connect Propulxia to 6,000+ apps through Zapier, no code required. The official integration is built on this API and its webhooks.

12. Error Codes

13. Limits

There are no strict rate limits in this version, subject to reasonable usage. The default pagination limits lists to 25 results (max 100).