# Wrapp Partners API Documentation

> AI-friendly Markdown version of the Wrapp Partners API Documentation.
> HTML version: https://wrapp.ai/api/partnersonboarding
> Base URL: `https://wrapp.ai/api/v1/`

## OVERVIEW

The Partners API is used to create and manage users in Wrapp via API calls.

An AI-friendly **Markdown** version of this documentation, ideal for LLMs and coding agents, is available at [`https://wrapp.ai/api/partnersonboarding.md`](/api/partnersonboarding.md)

## GETTING ACCESS

To use the Partners API, request an API key through the [contact form](/el/api/becomeapartner#contact).

Include the API key in your request headers as:

`X-PARTNER-API-KEY: <your_key_here>`

**API Base URL**

```
https://wrapp.ai/api/v1/
```

**# Example header**

```
X-PARTNER-API-KEY: xxxxxxxxxxxxxxxxxxxxxxxxxxx
```

## CREATE / LOGIN USER

To create a new user or log in an existing one, make a **POST** request to:
`https://wrapp.ai/api/v1/external_login`

Wrapp.ai will respond with a `login_url` that the user can use to log in.

### PARAMETERS

| Param Name | Required | Type | Description |
| --- | --- | --- | --- |
| email | yes | string | Email of the user that will be used to create their account in Wrapp.ai |
| partner_user_id | yes | string | External unique identifier that will be used to identify the user in Wrapp.ai |
| phone | yes | string | Phone of the user that will be used to create their account in Wrapp.ai |
| webhook_endpoint | no | string | Webhook endpoint that will return details on user creation |

**# Example request**

```bash
curl -L 'https://wrapp.ai/api/v1/external_login' \
-H 'X-PARTNER-API-KEY: XXXXXXXXXXXXXXXXXXXXXXXX' \
-H 'Content-Type: application/json' \
-d '{
     "email": "user@example.com",
     "partner_user_id": "abc123",
     "phone": "1234567890",
     "webhook_endpoint": "https://yoursite.com/webhook"
}'
```

**Response Success:**

```json
{
 "login_url": "https://wrapp.ai/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
```

## WEBHOOK · USER CREATED

If the user was created, Wrapp.ai will send the following payload to the provided `webhook_endpoint`:

### FIELDS

| Param Name | Description |
| --- | --- |
| wrapp_user_id | Id of the user in Wrapp |
| partner_user_id | Id of the user in partner (the id provided in the initial call) |
| api_key | API key of the user, used for further API actions on their behalf |

**# Webhook payload**

```json
{
 "wrapp_user_id": "xxxxx-xxxxx-xxxxx-xxxxx",
 "partner_user_id": "xxxxxxxxxx",
 "api_key": "xxxxxxxxxxxxxxxxxxxxx"
}
```

## CHECK USER

This endpoint shows if the user exists and whether they have an active subscription. Make a **POST** request to:
`https://wrapp.ai/api/v1/embedded_check_user`

### PARAMETERS

| Param Name | Required | Type | Description |
| --- | --- | --- | --- |
| partner_user_id | yes | string | Unique identifier that has been used to identify the user in Wrapp.ai |

### RESPONSE FIELDS

| Name | Type | Description |
| --- | --- | --- |
| user | string | User's email |
| active_subscription | boolean | User's subscription status |

**# Example request**

```bash
curl -L 'https://wrapp.ai/api/v1/embedded_check_user' \
-H 'X-PARTNER-API-KEY: XXXXXXXXXXXXXXXXXXX' \
-H 'Content-Type: application/json' \
-d '{"partner_user_id": "abc123"}'
```

**Response Success:**

```json
{
 "user": "user@example.com",
 "active_subscription": false
}
```

## Συχνές ερωτήσεις

Τι είναι το Wrapp Partners API;

Είναι το API multi-tenant onboarding της Wrapp: δημιουργείς και διαχειρίζεσαι λογαριασμούς Wrapp (subaccount ανά ΑΦΜ) για τους τελικούς πελάτες σου προγραμματιστικά, ώστε η εφαρμογή σου να τους ενεργοποιεί για έκδοση παραστατικών myDATA χωρίς χειροκίνητα βήματα.

Πώς δημιουργώ λογαριασμό Wrapp για κάθε πελάτη μου μέσω API;

Καλείς POST /api/v1/external_login με email, partner_user_id και τηλέφωνο. Η Wrapp επιστρέφει ένα login_url για τον χρήστη και, μόλις δημιουργηθεί ο λογαριασμός, στέλνει webhook με το wrapp_user_id και το api_key του tenant· με αυτό εκδίδεις παραστατικά για λογαριασμό του.

Πώς θα πάρω Partner API key (X-PARTNER-API-KEY);

Το Partners API ενεργοποιείται ανά συνεργάτη: ζήτησέ το μέσα από τη [φόρμα επικοινωνίας](/el/api/becomeapartner#contact)· λαμβάνεις staging key για δοκιμές και production key όταν είσαι έτοιμος.

Πώς ελέγχω αν ένας πελάτης έχει ήδη λογαριασμό ή ενεργή συνδρομή;

Με POST /api/v1/embedded_check_user και το partner_user_id: η απάντηση επιστρέφει το email του χρήστη και το αν έχει ενεργή συνδρομή (active_subscription).

Ποια είναι η διαφορά του Partner key από το API key του tenant;

Το X-PARTNER-API-KEY αφορά μόνο το onboarding: δημιουργία και έλεγχο χρηστών μέσω του Partners API. Κάθε tenant λαμβάνει δικό του api_key, με το οποίο κάνει login στο Invoice Issue API και εκδίδει τα παραστατικά του.

Ποιος υπογράφει σύμβαση και χρεώνει τον τελικό πελάτη;

Η Wrapp: ο τελικός χρήστης αποδέχεται ψηφιακά τη σύμβαση και πληρώνει τη συνδρομή του κατά το onboarding. Η εφαρμογή σου παραμένει το front-end· δεν διαχειρίζεσαι χρεώσεις ή συμβάσεις.