---
title: "Create several project template users at once"
method: POST
path: "/api/v3/account/project_template_users/batch"
tags: ["project template users"]
---

# Create several project template users at once

`POST /api/v3/account/project_template_users/batch`

## Request

- Base URL: `https://client-api.us.fieldwire.com`
- URL: `https://client-api.us.fieldwire.com/api/v3/account/project_template_users/batch`
- Auth: HTTP bearer

## Headers

- `Fieldwire-Version` string, date, required

## Request body

- ProjectTemplateUserBatchCreateInput: Schema for project_template_user_batch
  - `project_template_users` ProjectTemplateUserCreateInput[]: Project Template Users to create together
    - `id` string, uuid: ID of the entity
    - `account_id` integer: ID of the user account
    - `project_template_id` string, uuid: ID of the project template this entity belongs to
    - `role` 'admin' | 'member' | 'follower' | 'null', nullable, required: Role this user will hold in the project
    - `user_id` integer, required: ID of the user to copy over to the project
    - `device_created_at` string, date-time: Time when the device created the entity
    - `device_updated_at` string, date-time: Time when the device last updated the entity
    - `creator_user_id` integer: ID of the user who created this entity
    - `last_editor_user_id` integer: ID of the user who most recently edited this entity

## Response `201`

Successful full response

- ProjectTemplateUser[]
  - `id` string, uuid, required: ID of the entity
  - `account_id` integer, required: ID of the user account
  - `project_template_id` string, uuid, required: ID of the project template this entity belongs to
  - `role` 'admin' | 'member' | 'follower' | 'null', nullable, required: Role this user will hold in the project
  - `user_id` integer, required: ID of the user to copy over to the project
  - `created_at` string, date-time, required: Time when the server created the entity
  - `device_created_at` string, date-time, required: Time when the device created the entity
  - `resolved_conflict` boolean, required: Specifies if PUT/PATCH request was rejected - do not store this field!
  - `device_updated_at` string, date-time, required: Time when the device last updated the entity
  - `updated_at` string, date-time, required: Time when the server last updated the entity
  - `deleted_at` string, date-time, nullable: Time the server deleted the entity
  - `creator_user_id` integer, required: ID of the user who created this entity
  - `last_editor_user_id` integer, required: ID of the user who most recently edited this entity
  - `user` User: General information of a user
    - `id` integer, required: ID of user
    - `account_id` integer, nullable: ID of the account this user belongs to
    - `invited_by_id` integer, nullable: ID of the user who invited this user to the platform
    - `is_email_deliverable` boolean, required: If email can be delivered to this user
    - `company` string, nullable: Name of the company this user belongs to
    - `company_type` 'ARCHITECT_SLASH_DESIGNER' | 'GENERAL_CONTRACTOR' | 'OWNER' | 'SPECIALTY_CONTRACTOR' | 'OTHER' | 'null', nullable: Type of the company this user belongs to
    - `email` string, required: Email of this user
    - `first_name` string, required: First name of this user
    - `job_title` string, nullable: Title this user holds at their job
    - `language` string, required: Preferred language of this user
    - `last_name` string, required: Last name of this user
    - `phone_number` string, nullable: Phone number of this user
    - `photo_url` string, nullable: URL where the profile picture of this user lives
    - `email_notifications` 'never' | 'daily' | 'instantly' | 'null', nullable: Email notification preference of this user for delivering task updates
    - `sync_scheme` 'smart_cellular' | 'full_cellular', required: Synchronization scheme of this user used by the mobile apps
    - `account_role` 'account_member' | 'account_admin': The role of the user in the account they belong to
    - `email_addresses` object[]: Deprecated. Use the "email" property instead
    - `is_confirmed` boolean: Whether the user has accepted the invitation if there was one
    - `created_at` string, date-time, required: Time when the server created this user
    - `current_sign_in_at` string, date-time, nullable: Last time the user was seen online
    - `in_app_purchase_end_at` string, date-time, nullable: When the in app purchase this user made ends
    - `updated_at` string, date-time, required: Time when the server last updated this user
    - `trade_type` 'CONCRETE' | 'EARTHWORK' | 'ELECTRICAL' | 'FIRE_SUPPRESSION' | 'FRAMING_AND_OR_DRYWALL' | 'HVAC' | 'LOW_VOLTAGE' | 'MECHANICAL' | 'PLUMBING' | 'UTILITIES' | 'OTHER' | 'null', nullable: Type of the trade this user's company belongs to
  - `default_company_id` string, uuid, nullable: ID of the Default Company this entity belongs to
  - `default_company_name` string, nullable: Name of the Default Company this entity belongs to

---

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