{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Data Push API","description":"API documentation for Celonis APIs.","siteUrl":"https://developer.celonis.com/","keywords":"celonis developer portal, celonis apis, celonis api reference docs","lang":"en-US","llmstxt":{"hide":false,"description":"Celonis API documentation","sections":[{"title":"API Docs","description":"Available Celonis API Docs","includeFiles":["**/*.md"]},{"title":"API Specs","description":"All Celonis API specifications","includeFiles":["**/openapi.yaml"]}]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"data-push-api","__idx":0},"children":["Data Push API"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Important"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Data Push API is not recommended for new implementations. We recommend that you use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/data-ingestion-api/standard/standard_overview"},"children":["Data Ingestion API"]}," to pull your data into the Celonis Platform."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"base-url","__idx":1},"children":["Base URL"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The base URL for the Data Push API is:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["https://",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["your-team"]},".celonis.cloud/data-ingestion/api"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Replace ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["your-team"]}," with the name of your Celonis instance to access the Data Push API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":2},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Access to a Celonis team."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An OAuth connection prior to initiating a Data Push Job."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"use-case","__idx":3},"children":["Use Case"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Data Push API can be used to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Push data to the Celonis Platform using chunks, such as Parquet (preferred) or a CSV file, by sending to a Data Push job."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authentication","__idx":4},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This API supports multiple methods of authentication:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["(recommended method) Via OAuth 2.0 token with scope ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data-push"]},", passed in an HTTP header like this: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization: Bearer TOKEN"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Via Application keys, passed in an HTTP header like this: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization: AppKey APPLICATION_KEY"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Via API keys, passed in an HTTP header like this: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization: Bearer API_KEY"]},"."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Important"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Support for the Application Key and API Key methods is being discontinued. Sunsetting milestones will be officially announced."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.celonis.com/en/using-oauth-2-0.html"},"children":["this page"]}," for more information about using OAuth 2.0."]}]},"headings":[{"value":"Data Push API","id":"data-push-api","depth":1},{"value":"Base URL","id":"base-url","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Use Case","id":"use-case","depth":2},{"value":"Authentication","id":"authentication","depth":2}],"frontmatter":{"seo":{"title":"Data Push API"}},"lastModified":"2026-08-26T19:12:05.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/data-ingestion-api/overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}