# Unternehmen taggen (https://webmetic.de/docs/api/referenz/company-tags/company-tags-post)

## POST /company-tags

Gibt den Unternehmen hinter den Domains einen Tag, wie der CSV-Import im Dashboard.
Ein neuer Tag-Name legt den Tag an. Das Unternehmen muss Ihre Website noch nicht besucht
haben: der Tag steht schon da, wenn es kommt. Bestehende Tags bleiben, ein zweiter Aufruf
mit derselben Liste ändert nichts.

### Anfrage

`application/json`

| Feld | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `tag` | string | ja | Name des Tags, z. B. 'Zielkunde'. Groß- und Kleinschreibung zählt nicht; ein neuer Name legt den Tag an (nur POST). |
| `domains` | string[] | ja | 1 bis 10.000 Domains oder URLs der Unternehmen, z. B. 'acme.de'. |

### Antworten

| Status | Beschreibung |
| --- | --- |
| 200 | Getaggt |
| 400 | NO_WEBSITE: im Konto ist keine Website eingetragen |
| 403 | API_KEY_MISSING, API_KEY_INVALID oder API_KEY_NOT_FOUND |
| 422 | VALIDATION_ERROR: tag oder domains fehlt oder ist ungültig (höchstens 10.000 Domains) |
| 500 | INTERNAL_ERROR: unerwarteter Serverfehler |

Felder der Antwort 200:

| Feld | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `tagged` | integer | ja | Domains, deren Unternehmen den Tag jetzt trägt; auch wenn es ihn schon hatte |
| `unknown` | string[] | ja | Eingaben ohne Unternehmen im Register, unverändert zurückgegeben |

### Beispiel

```bash
curl -X POST 'https://hub.webmetic.de/company-tags' \
  -H 'Authorization: wmtc_IHR_API_SCHLUESSEL' \
  -H 'Content-Type: application/json' \
  -d '{"tag":"Zielkunde","domains":["bergquell.example","hagedorn.example"]}'
```