Coupa

This page records how composerID publishes into Coupa: the vendor’s API posture, the publish target and field mapping, and the documentation each claim rests on. It is for anyone evaluating the connection or building against it. Coupa is a Business Spend Management platform with a single clean REST surface. Contingent and services spend (SOW, Coupa Contingent Workforce) sits on top of requisitions, contracts and purchase_orders. composerID publishes canonical intent into those resources.

Category: Vendor Management & Sourcing. Coverage status: Specification mapped. Vendor documentation: public developer portal.

Integration path

How composerID connects to this destination, at a glance.

Step	Detail
Authentication	OAuth 2.0 / OIDC client-credentials with scopes.
composerID publishes	Requisition (Contingent): POST /api/requisitions
Intent ID lands on	`requisition` `custom-fields.intent-id`, written into the destination record
Back-sync	Webhooks and polling: some lifecycle events are pushed, the rest are read on a schedule.

Vendor documentation

The Coupa Core API (Compass)

Coupa Core API: Get Started

OAuth 2.0 and OIDC

Exception handling & rate limits

API posture

Aspect	Detail
Authentication	OAuth 2.0 / OIDC client-credentials with scopes. Token POST https://{instance}.coupahost.com/oauth2/token. Legacy X-COUPA-API-KEY header is retired.
Style	REST, JSON or XML via Accept header
Base URL	https://{instance}.coupahost.com/api/{resource} (events at https://{instance}.cso.coupahost.com/api/events)
Webhooks	Poll-first via updated-at filters. Events API (CSO) + configurable webhooks supplement; not comprehensive native webhooks.
Events posture	Webhooks and polling
Rate limits	25 requests/second, burst queue ~20; exponential backoff on 429/503.
Objects	requisitions, purchase_orders, invoices, contracts, suppliers, quote_requests, expenses, budget_lines

Publish target and field mapping

Each object below pairs the canonical intent fields with the destination’s own fields and operations. The mapping is indicative until it is confirmed against a tenant at onboarding.

Requisition (Contingent)

Create external worker request

Mapping	Detail
Canonical to destination	role_title, start_date, end_date, cost_center, worker_type
Target	POST /api/requisitions
Requirement	Required
Notes	CCW / Services modelled on requisitions

Statement of Work

Services / SOW engagement

Mapping	Detail
Canonical to destination	service_category, sow.summary, deliverables[], budget, dates
Target	/api/contracts + /api/requisitions
Requirement	Tenant required
Notes	Verify CCW module resource name per tenant

Intent ID correlation

Carry the Intent ID

Mapping	Detail
Canonical to destination	intent_id, intent_version
Target	custom-fields on the requisition / order header
Requirement	Required
Notes	Coupa custom fields are instance-configured and queryable once defined

Purchase Order

Read for back-sync

Mapping	Detail
Canonical to destination	po_number, supplier, amount, status
Target	GET /api/purchase_orders
Requirement	Required
Notes	Used for reconciliation

SOW / Contingent Workforce is not a distinct top-level REST resource; confirm the CCW module resource name in your tenant. Each customer has a separate sandbox instance with its own OAuth clients and scopes.

Next steps

How composerID connects

The five ways composerID reaches a destination, and the minimum a destination must offer.

Publishing

Plan, preflight and publish: how a decision becomes a valid record in a destination.

All destinations

Every destination composerID documents, with its category and coverage status.

⌘I

Get started

Concepts

Guides

Destinations

Upstream connectors

API reference

Endpoints

Manuscript API (Triage)

Manuscript endpoints

Resources

Integration path

Vendor documentation

The Coupa Core API (Compass)

Coupa Core API: Get Started

OAuth 2.0 and OIDC

Exception handling & rate limits

API posture

Publish target and field mapping

Next steps

How composerID connects

Publishing

All destinations

​Integration path

​Vendor documentation

The Coupa Core API (Compass)

Coupa Core API: Get Started

OAuth 2.0 and OIDC

Exception handling & rate limits

​API posture

​Publish target and field mapping

​Next steps

How composerID connects

Publishing

All destinations

Integration path

Vendor documentation

API posture

Publish target and field mapping

Next steps