{"openapi":"3.1.0","info":{"title":"POST /api/v1/ramp/connect-with-credentials","version":"1.0.0","description":"Connect Ramp with your own API credentials"},"servers":[{"url":"https://api.ondayzero.com","description":"Production"}],"paths":{"/api/v1/ramp/connect-with-credentials":{"post":{"tags":["ramp"],"summary":"Connect Ramp with your own API credentials","description":"Connect Ramp using your own Client ID and Client Secret from a Ramp Developer App. This allows you to use the Client Credentials OAuth flow instead of the standard redirect-based OAuth flow. Create your app at: Ramp Dashboard → Company → Developer.","operationId":"connect_with_credentials_api_v1_ramp_connect_with_credentials_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-business-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Business-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RampApiCredentialsRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad Request - Invalid input","content":{"application/json":{"example":{"detail":"Invalid request parameters"}}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"example":{"detail":"Not authenticated"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"example":{"detail":"Not enough permissions"}}}},"409":{"description":"Conflict - Resource already exists","content":{"application/json":{"example":{"detail":"Resource already exists"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"RampApiCredentialsRequest":{"properties":{"client_id":{"type":"string","minLength":1,"title":"Client Id","description":"Ramp Developer App Client ID"},"client_secret":{"type":"string","minLength":1,"title":"Client Secret","description":"Ramp Developer App Client Secret"}},"type":"object","required":["client_id","client_secret"],"title":"RampApiCredentialsRequest","description":"Request body to connect Ramp using per-business API credentials.\n\nThis enables the client credentials OAuth flow where businesses create\ntheir own Ramp Developer App and use their own Client ID and Client Secret\ninstead of going through DayZero's OAuth redirect flow.\n\nGet credentials from: Ramp Dashboard → Company → Developer → Create New App\nRequired grant type: Client Credentials\nRequired scopes: transactions:read (and any other scopes needed)"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Token","description":"API token authentication. Format: `Bearer dz_...`"}}},"security":[{"BearerAuth":[]}]}