Register a connection point in ION Desk for your external application, specifying whether it publishes, subscribes, or both, and the BOD verb/noun combinations it handles (e.g. Sync.CustomerPartyMaster)
Obtain OAuth 2.0 credentials from the ION API Gateway service account; use the client credentials grant to get a Bearer token for API calls
To publish a BOD outbound, POST a well-formed OAGIS-compliant XML or JSON BOD payload to the ION API Gateway endpoint; include the ApplicationArea with Sender, CreationDateTime, and BODID
Subscribe to inbound BODs by configuring a data flow in ION Desk that routes matching BODs to your registered connection point's inbound queue or webhook URL
Validate BODs against the OAGIS schema before publishing; ION rejects malformed BODs with a schema validation error that can be difficult to trace back to the specific field
Known gotchas
ION processes BODs asynchronously; a 200 response from the API Gateway confirms the BOD was accepted into the queue, not that it was processed or delivered to the subscriber
BOD routing in ION Desk is configured by administrators in the ION UI, not by the API client; if a BOD you publish is not arriving at the subscriber, the data flow configuration is the first place to check, not the API code
OAGIS BOD structures use a strict namespace and element ordering; generating BODs by string concatenation instead of an XML library almost always produces namespace or ordering errors that are valid XML but invalid per the OAGIS schema
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp