---
title: "Bulk import contacts to the tester group"
method: POST
path: "/api/v3/tester-groups/{tester_group_id}/contacts"
tags: ["Tester Groups"]
---

# Bulk import contacts to the tester group

`POST /api/v3/tester-groups/{tester_group_id}/contacts`

## Request

- Base URL: `https://codemagic.io`
- URL: `https://codemagic.io/api/v3/tester-groups/{tester_group_id}/contacts`
- Auth: API key in header `x-auth-token`
- TypeScript: <https://skmtc.dev/codemagic/apis/codemagic-api/docs/api/v3/tester-groups/:tester_group_id/contacts/post.ts> (a function with typed inputs; its response is checked against the schema)

<!-- theme: warning -->
> The bulk import API is not designed to sync updates in real-time from an external database.

### Skipped contacts

Contacts must meet all the following criteria in order to be created or updated with this API:

- The imported contacts may not exceed your account limit.
- The contact must have a valid email address.
- The contact's email address must not be on an exclusion list.
- The contact's email must not be on a list of bounced email addresses.

If contacts do not meet all of these requirements, they will be skipped by the importer.

## Path parameters

- `tester_group_id` string, required

## Request body

- TesterGroupsSchemasBulkImportSchema
  - `emails` string[], required

## Response `201`

Document created, URL follows

## Other responses

- `400`: The request could not be validated
- `401`: Authentication is missing or invalid
- `402`: The maximum number of contacts has been reached
- `403`: The caller lacks the required permission
- `404`: The requested resource does not exist
- `429`: The rate limit has been exceeded

---

[API](https://skmtc.dev/codemagic/apis/codemagic-api.md) - [All operations](https://skmtc.dev/codemagic/apis/codemagic-api/llms.txt) - [OpenAPI document](https://skmtc.dev/codemagic/apis/codemagic-api/revisions/be09630f65e2?raw)