# flow2act · Nutzerimport prüfen

Prüfe bis zu 100 Personen ohne Profile, Konten oder E-Mails anzulegen.

Nutze in Live eine Administratorsitzung und in der Sandbox eine Administrator-/Entwicklersitzung. Integrationen benötigen einen Servicekonto-Schlüssel mit organization:write UND users:invite. Schlüssel dürfen nur Importe desselben Servicekontos lesen/wiederholen. Zugriffe werden während der Hintergrundverarbeitung erneut geprüft.

## POST /v1/organization/user-imports/validate

Authentication: restricted integration key (scope: users:invite) or flow2act sign-in access token
Required tenant header: X-Organization-Id.
Required user permissions: Administrator oder Sandbox-Entwickler erforderlich. The API checks current membership, roles, key scopes and resource permissions on every request. Documentation visibility grants no access.

## Input parameters
- people (array, required): min items 1 · max items 100

## Request example (replace example IDs)

```sh
curl -X POST "https://api.flow2act.com/v1/organization/user-imports/validate" \
  -H "authorization: Bearer $FLOW2ACT_API_KEY" \
  -H "x-organization-id: 10000000-0000-4000-8000-000000000001" \
  -H "content-type: application/json" \
  --data-raw '{
  "people": [
    {
      "ref": "ceo",
      "externalId": "employee-1",
      "displayName": "Alex Example",
      "email": "alex@example.com",
      "jobTitle": "CEO",
      "managerRef": null
    },
    {
      "ref": "lead",
      "externalId": "employee-2",
      "displayName": "Kim Example",
      "email": "kim@example.com",
      "jobTitle": "Team Lead",
      "managerRef": "ceo"
    }
  ]
}'
```

## Response excerpt

```json
{
  "valid": true,
  "issues": [],
  "summary": {
    "people": 2,
    "created": 2,
    "updated": 0,
    "alreadyLinked": 0,
    "invitations": 2
  }
}
```

Source: /docs/validate-user-import
Full schemas: /docs/openapi.json