# Java SDK (/docs/sdks/java)



The official Insion Java SDK lets JVM applications moderate content, ingest records, manage users, and submit appeals without constructing HTTP requests. This guide walks you through adding the SDK, creating an authenticated client, and sending a record for immediate moderation.

## Before you begin [#before-you-begin]

You'll need:

* An [Insion account](/sign-up).
* An API key from the [Developer section](/dashboard/developer) of your dashboard.
* A Java project using Maven.

<Callout type="info">
  Use immediate moderation when your application needs a decision in the current request. Use ingestion when moderation
  can happen asynchronously and your application receives the result through a webhook.
</Callout>

## Install [#install]

Add the Maven artifact `co.insion:insion` to your project dependencies.

## Make your first request [#make-your-first-request]

```java
import co.insion.InsionClient;
import co.insion.requests.ModerateRequest;
import co.insion.types.Content;

InsionClient client = InsionClient.builder().token("<token>").build();
ModerateResponse result = client.moderateARecord(
    ModerateRequest.builder()
        .clientId("post-123").name("Welcome post").entity("post")
        .content(Content.of("Hello world")).build()
);
```

The client is synchronous and uses immutable request builders.

<Callout type="info">
  The SDK also exposes `AsyncInsionClient` when the asynchronous surface better fits the application.
</Callout>

## Next steps [#next-steps]

* Fine-tune client and request behavior in [Configuration](/docs/sdks/java/configuration).
* Explore every supported request and response in [Operations](/docs/sdks/java/operations).
* Prepare production error handling with [Errors](/docs/sdks/java/errors).

## Get Involved [#get-involved]

<Cards className="**:data-card:border-0">
  <Card title="GitHub repository" href="https://github.com/insion-co/java" description="Browse the Java SDK source and report issues." />

  <Card title="Maven Central artifact" href="https://central.sonatype.com/artifact/co.insion/insion" description="View co.insion:insion on Maven Central." />
</Cards>