# Create worker

**POST /v1/Workspaces/{WorkspaceSid}/Workers**




## Servers
- https://taskrouter.twilio.com: https://taskrouter.twilio.com ()


## Authentication methods
- Account sid auth token


## Parameters

### Path parameters
- **WorkspaceSid** (string)
  The SID of the Workspace that the new Worker belongs to.


### Body: application/x-www-form-urlencoded (object)

- **FriendlyName** (string)
  A descriptive string that you create to describe the new Worker. It can be up to 64 characters long.
- **ActivitySid** (string)
  The SID of a valid Activity that will describe the new Worker's initial state. See [Activities](https://www.twilio.com/docs/taskrouter/api/activity) for more information. If not provided, the new Worker's initial state is the `default_activity_sid` configured on the Workspace.
- **Attributes** (string)
  A valid JSON string that describes the new Worker. For example: `{ "email": "Bob@example.com", "phone": "+5095551234" }`. This data is passed to the `assignment_callback_url` when TaskRouter assigns a Task to the Worker. Defaults to {}.


## Responses
### 201
Created
#### Headers
- **ETag** (string)

- **X-Rate-Limit-Limit** (string)

- **X-Rate-Limit-Remaining** (string)

- **X-Rate-Limit-Config** (string)

- **Access-Control-Allow-Origin** (string)
  Specify the origin(s) allowed to access the resource
- **Access-Control-Allow-Methods** (string)
  Specify the HTTP methods allowed when accessing the resource
- **Access-Control-Allow-Headers** (string)
  Specify the headers allowed when accessing the resource
- **Access-Control-Allow-Credentials** (boolean)
  Indicates whether the browser should include credentials
- **Access-Control-Expose-Headers** (string)
  Headers exposed to the client

#### Body: application/json (object)
- **account_sid** (string | null)
  The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Worker resource.
- **activity_name** (string | null)
  The `friendly_name` of the Worker's current Activity.
- **activity_sid** (string | null)
  The SID of the Worker's current Activity.
- **attributes** (string | null)
  The JSON string that describes the Worker. For example: `{ "email": "Bob@example.com", "phone": "+5095551234" }`. **Note** If this property has been assigned a value, it will only be displayed in FETCH actions that return a single resource. Otherwise, this property will be null, even if it has a value. This data is passed to the `assignment_callback_url` when TaskRouter assigns a Task to the Worker.
- **available** (boolean | null)
  Whether the Worker is available to perform tasks.
- **date_created** (string(date-time) | null)
  The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
- **date_status_changed** (string(date-time) | null)
  The date and time in GMT of the last change to the Worker's activity specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. Used to calculate Workflow statistics.
- **date_updated** (string(date-time) | null)
  The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
- **friendly_name** (string | null)
  The string that you assigned to describe the resource. Friendly names are case insensitive, and unique within the TaskRouter Workspace.
- **sid** (string | null)
  The unique string that we created to identify the Worker resource.
- **workspace_sid** (string | null)
  The SID of the Workspace that contains the Worker.
- **url** (string(uri) | null)
  The absolute URL of the Worker resource.
- **links** (object(uri-map) | null)
  The URLs of related resources.


[Powered by Bump.sh](https://bump.sh)