{"componentChunkName":"component---src-templates-markdown-template-jsx","path":"/developers/quickstart/java/create-input/","result":{"data":{"pageMetadata":{"title":"Step 1. Create an input","path":"/developers/quickstart/java/create-input/","sourceCode":null,"metadataParent":{"title":"Java Quick Start","path":"/developers/quickstart/java/","sourceCode":null,"hasVersionPicker":null,"metadataChildren":[{"title":"Step 1. Create an input","path":"/developers/quickstart/java/create-input/","order":1,"label":null},{"title":"Step 2. Create an output","path":"/developers/quickstart/java/create-output/","order":2,"label":null},{"title":"Step 3. Verify output","path":"/developers/quickstart/java/verify-input/","order":3,"label":null}],"metadataParent":{"title":"Quickstart","path":"/developers/quickstart/","metadataChildren":[{"title":"Android","path":"/developers/quickstart/android/","order":null,"label":null},{"title":"HTTP Quick Start","path":"/developers/quickstart/http/","order":null,"label":null},{"title":"iOS Quick Start","path":"/developers/quickstart/ios/","order":null,"label":null},{"title":"Java Quick Start","path":"/developers/quickstart/java/","order":null,"label":null},{"title":"Node Quick Start","path":"/developers/quickstart/node/","order":null,"label":null},{"title":"Python Quick Start","path":"/developers/quickstart/python/","order":null,"label":null},{"title":"Web","path":"/developers/quickstart/web/","order":null,"label":null}],"metadataParent":{"title":"Developers","path":"/developers/","metadataChildren":[{"title":"API Credential Management","path":"/developers/credential-management/","order":null,"label":null},{"title":"API References","path":"/developers/apis/","order":null,"label":null},{"title":"Client SDKs","path":"/developers/client-sdks/","order":null,"label":null},{"title":"Guides","path":"/developers/guides/","order":null,"label":null},{"title":"Media SDKs","path":"/developers/media-sdks/","order":null,"label":null},{"title":"Quickstart","path":"/developers/quickstart/","order":null,"label":null},{"title":"Server SDKs","path":"/developers/server-sdks/","order":null,"label":null},{"title":"The Developer's Guided Journey to mParticle","path":"/developers/developersjourney/","order":null,"label":null},{"title":"Tools","path":"/developers/tools/","order":null,"label":null}],"metadataParent":null}}}},"markdownRemark":{"html":"

\n \n \n \n \n \n \n \n 1. Generate your API key

\n

Create a Custom Feed on the Setup page to generate server-to-server API credentials.

\n

\n \n \n \n \n \n \n \n 2. Add the mParticle SDK dependency

\n

Our Java SDK is available via Gradle or Maven.

\n
\n
\n

Add the SDK dependency to your build.gradle file.

\n
dependencies {\n  implementation 'com:mparticle:server-events-sdk:2+'\n}
\n
\n
\n

Add the SDK dependency to your pom.xml file.

\n
<dependency>\n  <groupId>com.mparticle</groupId>\n  <artifactId>server-events-sdk</artifactId>\n  <version>2.0.0</version>\n</dependency>
\n
\n
\n

\n \n \n \n \n \n \n \n 3. Call the Events API

\n

Now you can integrate mParticle in your Java application.

\n
// configure API\nEventsApi api = new ApiClient(\n        \"YOUR_API_KEY\",\n        \"YOUR_API_SECRET\")\n        .createService(EventsApi.class);\n\n// assemble an event batch\nBatch batch = new Batch();\nbatch.environment(Batch.Environment.DEVELOPMENT);\nbatch.userIdentities(new UserIdentities()\n        .customerId(\"1234\")\n        .email(\"example@foo.com\")\n);\n\n// Set a Data Plan\nContext context = new Context();\nDataPlanContext dpContext = new DataPlanContext();\ndpContext.planId(\"mobile_data_plan\");\ndpContext.planVersion(2);\ncontext.dataPlan(dpContext);\nbatch.context(context);\n\n// create an event\nCustomEvent customEvent = new CustomEvent().data(\n        new CustomEventData()\n                .eventName(\"bid\")\n);\n\n// create attributes\nMap<String, String> customAttributes = new HashMap<>();\ncustomAttributes.put(\"price\", 33);\n\n// add them to an event\ncustomEvent.getData().customAttributes(customAttributes);\nbatch.addEventsItem(customEvent);\n\n// upload\nCall<Void> singleResult = api.uploadEvents(batch);\nResponse<Void> singleResponse = singleResult.execute();\nSystem.out.println(\"Returned code: \" + singleResponse.code());
\n

\n \n \n \n \n \n \n \n 4. Verify installation

\n

Go to the Live Stream and watch new events come in as you run your application.

\n\n

\n \n \n \n \n \n \n \n Next Steps 🎉

\n

Congrats on sending your first event to mParticle!

\n

Some suggestions on what to do next:

\n\n

","frontmatter":{"title":"Step 1. Create an input","order":1,"seoTitle":null,"seoDescription":null},"parent":{"__typename":"File","modifiedTime":"July 27, 2026"}}},"pageContext":{"slug":"/developers/quickstart/java/create-input/"}},"staticQueryHashes":["2950460867