# Freshservice - Create agent action
This action allows you to create a new agent in Freshservice.
# Input
Input field | Description |
---|---|
First name | Provide the first name of the agent. |
Last name | Provide the last name of the agent. |
Occasional | Select the boolean value from the drop-down menu. Set true if the agent is an occasional agent, and false if a full-time agent. |
Job title | Provide the agent's job title. |
Provide the agent's email address. | |
Work phone number | Provide the agent's work phone number. |
Mobile phone number | Provide the agent's mobile phone number. |
Department IDs | Provide the unique IDs of the departments associated with the agent |
Can see all tickets from associated departments | Select the boolean value from the drop-down menu. Set to true if the agent must be allowed to view tickets filed by other members of the department, and false otherwise |
Reporting manager ID | Provide the user ID of the agent's reporting manager. |
Address | Provide the agent's address. |
Time zone | Provide the agent's time zone. |
Time format | Provide the agent's time format. Possible values include: 12h (12 hour format) and 24h (24 hour format). |
Language | Specify the language used by the agent. |
Location ID | Provide the unique ID of the location associated with the agent. |
Background information | Provide the background information of the agent. |
Scoreboard level ID | Provide the unique ID of the agent's level in the arcade. Possible values include: 1 (Beginner), 2 (Intermediate), 3 (Professional), 4 (Expert), 5 (Master), and 6 (Guru) |
Member of | Provide the unique IDs of the groups that the agent is a member of. |
Observer of | Provide the unique IDs of the groups that the agent is an observer of. |
Roles | Each individual role is a hash in the roles array that contains attributes like role ID, assignment scope, and groups. Provide the appropriate values in the respective fields. |
Signature | Provide the signature of the agent in HTML format. |
Custom fields | Provide the key-value pair containing the names and values of the (custom) agent fields. |
# Output
Field | Description |
---|---|
Agent ID | A unique identifier assigned to the agent. |
First name | First name of the agent. |
Last name | Last name of the agent. |
Occasional | Indicates whether the agent is an occasional user (true/false). |
Active | Indicates whether the agent is currently active (true/false). |
Job title | Job title of the agent. |
Email address of the agent. | |
Work phone number | Work phone number of the agent. |
Mobile phone number | Mobile phone number of the agent. |
Department IDs | Unique IDs of the departments associated with the agent. |
Can see all tickets from associated departments | Indicates whether the agent has access to all tickets within their department (true/false). |
Auto assign tickets | Indicates whether tickets are automatically assigned to the agent. |
External ID | A unique identifier for external system integrations. |
Department names | The names of the departments the agent is associated with. |
Auto assign status changed at | The timestamp when the auto-assign status was last changed. |
Reporting manager ID | User ID of the agent's reporting manager. |
Address | Address of the agent. |
Time zone | Time zone of the agent. |
Time format | Time format for the agent. |
Language | Language used by the agent. |
Location ID | Unique ID of the location associated with the agent. |
Background information | Background information of the agent. |
Scoreboard level ID | Unique ID of the level of the agent in the Arcade. |
Scopes | The permissions and access levels assigned to the agent. |
Member of | Unique IDs of the groups that the agent is a member of. |
Observer of | Unique IDs of the groups that the agent is an observer of. |
Roles | The roles assigned to the agent, defining their permissions. |
Last login at | The last recorded time the agent logged in. |
Last active at | The last recorded time the agent was active. |
Has logged in | Indicates whether the agent has ever logged into the system (true/false). |
Signature | Signature of the agent in HTML format. |
VIP user | Indicates whether the agent is considered a VIP user. |
Work schedule ID | The identifier for the agent’s assigned work schedule. |
Workspace IDs | The IDs of the workspaces the agent is associated with. |
Workspace info | Additional information about the agent’s workspace. |
Created at | The timestamp when the agent profile was created. |
Updated at | The timestamp when the agent profile was last updated. |
Custom fields | Key-value pair containing the names and values of the (custom) agent fields. |
Last updated: 3/24/2025, 4:44:59 PM