> For the complete documentation index, see [llms.txt](https://support.emarketeer.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.emarketeer.com/docs/docs_se/referens/apis-developer/api-endpoints-overview.md).

# Översikt över API-endpoints

En snabb karta över alla endpoints i eMarketeers REST-API:er — kontakter, prenumerationer, engagement, consent, taggar, meddelanden och kampanjer — så att du snabbt hittar rätt anrop.

Den här sidan listar alla endpoints i eMarketeers API, grupperade per modul, med en rad om vad varje anrop gör. Det är en karta, inte en fullständig referens. För request- och response-scheman, och för att testa anrop i webbläsaren, använd den interaktiva portalen på [api-doc.emarketeer.com](https://api-doc.emarketeer.com/).

API:et är uppdelat i moduler, var och en med sin egen OpenAPI-definition: **Contact**, **Subscription**, **Engagement**, **Consent**, **Tag**, **Messages** och **Campaigns**. Varje modul är ett REST-API som skickar och tar emot JSON.

{% hint style="info" %}
Alla anrop autentiseras med en API-nyckel som skickas i request-headern `x-api-key`. Du hittar din nyckel i eMarketeer under **Account Settings** → **Integrations** → **API Key**. Du behöver administratörsbehörighet för att generera en nyckel.
{% endhint %}

## Contact

Skapa, hitta och radera kontakter, hantera kontaktlistor och läsa anpassade kontaktfält.

* Bas-URL: `https://connect.emarketeer.com/contacts-api`
* Bläddra och testa: [Contact v2-definitionen](https://api-doc.emarketeer.com/?urls.primaryName=Contact%20v2)
* Version 1: [Contact-definitionen](https://api-doc.emarketeer.com/?urls.primaryName=Contact)

{% hint style="warning" %}
Version 1 av Contacts API (`/v1/`) är utfasad och slutar fungera den 1 maj 2027. Flytta din integration till v2-endpoints nedan innan dess.
{% endhint %}

Varje v1-endpoint har en v2-endpoint med samma sökväg, med `/v2/` i stället för `/v1/`. Endpoints som returnerar många objekt är uppdelade i sidor: använd `pageNumber` (börjar på 0) och `pageSize` (högst 100, standard 25).

### Kontakter

* `POST /v2/contacts` — Skapa eller uppdatera upp till 100 kontakter åt gången, matchade på e-postadress.
* `GET /v2/contacts` — Hitta kontakter via sparat filter, e-post eller skapad-/ändrad-datum.
* `POST /v2/contacts/delete` — Radera kontakter via e-postadress (upp till 100 åt gången).
* `GET /v2/contacts/{contactId}/lists` — Hämta de kontaktlistor som en kontakt är medlem i.

### Kontaktlistor

* `GET /v2/lists` — Hämta alla kontaktlistor, inklusive nästlade listor.
* `POST /v2/lists` — Skapa en kontaktlista.
* `DELETE /v2/lists` — Radera kontaktlistor (upp till 25 åt gången).
* `GET /v2/lists/{contactListId}` — Hämta kontakterna i en kontaktlista.
* `POST /v2/lists/{contactListId}` — Lägg till kontakter i en kontaktlista (upp till 1000 åt gången).
* `DELETE /v2/lists/{contactListId}` — Ta bort kontakter från en kontaktlista (upp till 1000 åt gången).

### Anpassade kontaktfält

* `GET /v2/contacts/customFields` — Lista alla anpassade kontaktfält på kontot.

## Subscription

Hantera en kontakts prenumerationer och lista de kampanjer som går att prenumerera på.

* Bas-URL: `https://prod-apigw.emarketeer.com`
* Bläddra och testa: [Subscription-definitionen](https://api-doc.emarketeer.com/?urls.primaryName=Subscription)

### Prenumerationer

* `GET /subscriptions/v1/subscriptions` — Hämta en prenumeration via e-post och prenumerationsnamn.
* `POST /subscriptions/v1/subscriptions` — Lägg till en prenumeration.
* `DELETE /subscriptions/v1/subscriptions` — Radera en prenumeration.

### Kampanjer

* `GET /subscriptions/v1/campaigns` — Lista kampanjer, nyast först, med valfri mappfiltrering och paginering.

## Engagement

Läs en kontakts engagement med kampanjkomponenter, och skicka in externa engagement-signaler till eMarketeer.

* Bas-URL: `https://connect.emarketeer.com/engagements-api/v1`
* Bläddra och testa: [Engagement-definitionen](https://api-doc.emarketeer.com/?urls.primaryName=Engagement)

### Signals

* `POST /signals` — Skicka en signal: ett externt engagement för en kontakt, till exempel en formulärinsändning eller en webbinteraktion från ett annat system.

### Engagement per komponent

* `GET /engagements/contact/{contactId}` — Hämta alla engagement för en kontakt.
* `GET /engagements/email/{componentId}` — Engagement för en e-postkomponent.
* `GET /engagements/sms/{componentId}` — Engagement för en SMS-komponent.
* `GET /engagements/form/{componentId}` — Engagement för en formulärkomponent.
* `GET /engagements/landingPage/{componentId}` — Engagement för en landningssidekomponent.
* `GET /engagements/website` — Engagement för en webbplats, via webbplatsnamn.
* `GET /engagements/linkedinLeadGenForm` — Engagement för ett LinkedIn Lead Gen Form.

## Consent

Läs och registrera kontakters consent, och slå upp stamdata för consent (purposes, legal bases, sources).

* Bas-URL: `https://prod-apigw.emarketeer.com`
* Bläddra och testa: [Consent-definitionen](https://api-doc.emarketeer.com/?urls.primaryName=Consent)

### Consent

* `GET /consent-public/v1/consents` — Hämta consent för en nyckel, eller alla consents för den aktuella användaren om ingen nyckel anges.
* `GET /consent-public/v1/consents/filter` — Hämta consents som matchar ett filter.
* `GET /consent-public/v1/consents/history` — Hämta consent-historiken för en nyckel.
* `POST /consent-public/v1/consents` — Skapa en consent-post.

### Stamdata för consent

* `GET /consent-public/v1/purposes` — Lista alla purposes.
* `GET /consent-public/v1/legalBases` — Lista alla legal bases.
* `GET /consent-public/v1/sources` — Lista alla sources.

## Tag

Visa, skapa, uppdatera och radera taggar, och tilldela taggar till kontakter i bulk.

* Bas-URL: `https://connect.emarketeer.com/tags-api/v1`
* Bläddra och testa: [Tag-definitionen](https://api-doc.emarketeer.com/?urls.primaryName=Tag)

### Taggar

* `GET /tags` — Hämta alla taggar, med paginering.
* `POST /tags` — Skapa en tagg med namn, färg och kategori.
* `GET /tags/{tagId}` — Hämta en tagg via dess ID.
* `PUT /tags/{tagId}` — Ersätt alla fält i en tagg.
* `DELETE /tags/{tagId}` — Radera en tagg.
* `GET /tags/name/{tagName}` — Hämta en tagg via dess namn.

### Kontakttaggar

* `POST /tags/add-contacts-tags` — Lägg till flera taggar på flera kontakter i ett anrop.
* `POST /tags/remove-contacts-tags` — Ta bort flera taggar från flera kontakter i ett anrop.

## Messages

Skicka e-post och SMS till kontakter.

Använd Messages API för att skicka till enskilda kontakter, högst 10 åt gången. För att skicka ett e-postmeddelande till en hel kontaktlista använder du Campaigns API (se [Skicka](#skicka) nedan).

* Bas-URL: `https://connect.emarketeer.com/messages-api`
* Bläddra och testa: [Messages-definitionen](https://api-doc.emarketeer.com/?urls.primaryName=Messages)

### E-post

* `POST /v1/email/send` — Skicka e-post till upp till 10 kontakter.

### SMS

* `POST /v1/sms/send` — Skicka SMS till upp till 10 kontakter.

## Campaigns

Kopiera, byt namn på och flytta kampanjkomponenter, fyll i innehållet i e-post och landningssidor, och skicka e-post till en kontaktlista.

* Bas-URL: `https://connect.emarketeer.com/campaigns-api/v1`
* Bläddra och testa: [Campaigns-definitionen](https://api-doc.emarketeer.com/?urls.primaryName=Campaigns)

### Komponenter

* `POST /components/{componentType}/{componentId}/copy` — Kopiera ett e-postmeddelande, SMS, formulär, legacy-formulär eller en landningssida till samma kampanj.
* `PATCH /components/{componentType}/{componentId}` — Byt namn på en komponent, flytta den till en annan kampanj, eller båda.

### Innehåll

* `GET /components/{componentType}/{componentId}/content` — Lista innehållsblocken i ett e-postmeddelande eller en landningssida, med deras sökvägar och nuvarande värden.
* `PATCH /components/{componentType}/{componentId}/content` — Fyll i upp till 50 innehållsblock i ett e-postmeddelande eller en landningssida i ett anrop.

### Skicka

* `POST /components/{componentType}/{componentId}/send` — Skicka ett e-postmeddelande till en kontaktlista, direkt eller vid en schemalagd tidpunkt. Det kan utesluta kontakter som redan har fått e-postmeddelandet (`sendOnce`).

## Nästa steg

För fullständiga request- och response-scheman, och för att testa anrop live, öppna [API-portalen](https://api-doc.emarketeer.com/). För att skicka engagement-händelser från ett annat system, se [Custom Signals API](https://support.emarketeer.com/docs/docs_se/referens/apis-developer/custom-signals-api.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://support.emarketeer.com/docs/docs_se/referens/apis-developer/api-endpoints-overview.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
