Action: Create Client

Toggl Track Operation

The Create Client action creates a new client record in the time-tracking system.

Example User Story

I want to create a new client in Toggl Track so that I can track time for projects associated with that client.

Fields

Field Name	Field Type	Required
name	String	Yes
workspace_id	Integer	Yes
notes	String	No

Related Connections

Toggl Track

Related Automations

Example link

Code (Apache v2.0): Operation

{
  "handle": "create-client",
  "state": "inDev",
  "meta": {
    "short": "Create Client",
    "description": "Creates a new client in Toggl Track."
  },
  "input": [
    {
      "name": "name",
      "type": "String",
      "required": true,
      "meta": {
        "description": "Name of the client."
      }
    },
    {
      "name": "workspace_id",
      "type": "Integer",
      "required": true,
      "meta": {
        "description": "ID of the workspace where the client will be created."
      }
    },
    {
      "name": "notes",
      "type": "String",
      "required": false,
      "meta": {
        "description": "Additional notes about the client."
      }
    }
  ],
  "output": [
    {
      "name": "client_id",
      "type": "Integer",
      "selector": ["id"],
      "meta": {
        "description": "ID of the created client."
      }
    },
    {
      "name": "client_name",
      "type": "String",
      "selector": ["name"],
      "meta": {
        "description": "Name of the created client."
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "POST",
        "path": "/api/v9/workspaces/{{workspace_id}}/clients",
        "headers": {
          "Content-Type": "application/json"
        },
        "bodyTemplate": {
          "value": "{\"client\":{\"name\":\"{{name}}\",\"notes\":\"{{notes}}\"}}",
          "placeholders": [
            {
              "name": "name",
              "type": "String",
              "description": "Name of the client.",
              "required": true
            },
            {
              "name": "notes",
              "type": "String",
              "description": "Additional notes about the client.",
              "required": false
            }
          ]
        }
      }
    }
  ]
}