# Your first integration

This walkthrough takes you from an empty dashboard to a working push notification in a few minutes.

## 1. Create the integration

From the dashboard, click **Create Integration**, give it a **name** (e.g. "Deploy alerts") and an optional **description**, and confirm. Studio creates the integration and opens it for you.

## 2. Copy your endpoint URL

At the top of the integration you'll see the **endpoint URL**. This is where external services send their webhooks. Click the copy icon to grab it.

See [Endpoint URL & token](/introduction/justpush-studio/integrations/endpoint-and-token.md) for how requests are authorized.

## 3. Write a little code

In the **Code Editor**, write JavaScript that turns the incoming request into a message. A minimal example:

```javascript
// Build a push message from the incoming webhook
return {
    title: "Hello from Studio",
    message: "My first integration is live!",
    topic: "Default"
}
```

> The exact way your code reads the incoming request and returns a message is covered in [Execution model](/introduction/justpush-studio/writing-code/execution-model.md). The fields you can set are listed in [The message object](/introduction/justpush-studio/writing-code/the-message-object.md).

## 4. Save a revision

Click **Save**. Studio stores your code as a numbered **revision**. Until you save, the editor shows **Not saved yet**.

## 5. Test it

Click **Test**, craft a sample request (method, headers, body), and run it. You'll see the result without needing a real external service. See [Testing your code](/introduction/justpush-studio/testing-and-monitoring/testing-your-code.md).

## 6. Go live

Point your external service's webhook at the endpoint URL. When it fires, Studio runs your code and delivers the message to your JustPush devices. Watch requests arrive in real time under [Request history](/introduction/justpush-studio/testing-and-monitoring/request-history.md).

🎉 That's the whole loop: **receive → transform → deliver.**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.justpush.io/introduction/justpush-studio/getting-started/your-first-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.