SETUP<br>1. Get your ClickUp Personal API Token:<br> - Log in to ClickUp<br> - Go to Settings (bottom-left avatar) → Apps → "API Token"<br> - Copy your personal token<br>2. Install this plugin in your Bubble app.<br>3. Open Plugins → ClickUp → paste your API Token into the "clickup_api_token" field.<br>---<br>FINDING YOUR LIST ID<br>The List ID is the number in the ClickUp URL when you open a list:<br>https://app.clickup.com/123456/v/l/li/LIST_ID_HERE<br>You can also find it via the ClickUp API:<br>GET https://api.clickup.com/api/v2/space/{space_id}/list<br>---<br>USING THE ACTION<br>In any Bubble workflow, add the action:<br>Plugins → Create ClickUp Task<br>Required fields:<br>- list_id: The numeric ID of the ClickUp list (e.g. 901234567890)<br>- name: The task title<br>Optional fields:<br>- description: Plain text task description<br>- status: Exact status name from your list (e.g. "to do", "in progress")<br>- priority: Number 1–4 (1=urgent, 2=high, 3=normal, 4=low)<br>- due_date_ms: Due date. In Bubble set field type to "date" — plugin converts it automatically<br>- start_date_ms: Start date (same format as due_date_ms)<br>- assignee_ids: Comma-separated ClickUp user IDs (e.g. "123456,789012")<br>- tags: Comma-separated tag names (e.g. "billing,urgent,q2")<br>- custom_fields_json: JSON array of custom fields (see section below)<br>---<br>CUSTOM FIELDS<br>Use the custom_fields_json field to populate any ClickUp custom fields on the task.<br>Format: a valid JSON array where each item has "id" (the custom field UUID from ClickUp) and "value".<br>Step 1. Get your custom field IDs.<br>Ask a ClickUp AI agent or use the API:<br>GET https://api.clickup.com/api/v2/list/{list_id}/field<br>This returns all custom fields with their UUIDs.<br>Step 2. Build the JSON string in Bubble.<br>In the custom_fields_json input, use Bubble's expression editor to compose the value dynamically. Example:<br>[{"id":"a5ba39ac-3e31-4a3c-a70d-7eb220adb41d","value":"Input Status value"},<br>{"id":"4d02c170-f170-4ce8-979c-1e108aa12285","value":"Current User's email"},<br>{"id":"225aa366-a084-44fb-9d39-591f655bfd44","value":"Input Phone value"}]<br>Replace the value parts with Bubble dynamic expressions — Bubble substitutes the real values before sending the string to the plugin.<br>Step 3. The plugin receives the ready string, parses it with JSON.parse(), and sends it to ClickUp as the custom_fields array in the request body.<br>Value types by field type:<br>- Text / URL / Email → "value": "string"<br>- Number → "value": 123<br>- Date → "value": 1712345678000 (Unix ms)<br>- Dropdown → "value": "option-uuid"<br>- Checkbox → "value": true<br>Note: if the JSON is malformed, the action will throw a clear error: "custom_fields_json is not valid JSON".<br>---<br>ACTION OUTPUTS<br>After the action runs, access the results with:<br>- Result of Create ClickUp Task's task_id — use to update records, show confirmation, etc.<br>- Result of Create ClickUp Task's task_url — direct link to the new task in ClickUp<br>- Result of Create ClickUp Task's task_name — confirmed task title returned by ClickUp<br>---<br>EXAMPLE WORKFLOW<br>Trigger: Button click "Submit Request"<br>1. Create ClickUp Task<br> list_id = "901234567890"<br> name = Input Task Title's value<br> description = Multiline Input's value<br> tags = "support,new"<br> priority = 2<br> due_date_ms = DatePicker's value<br> custom_fields_json = [{"id":"field-uuid-1","value":"} + Input Status's value + {"},{"id":"field-uuid-2","value":"} + Current User's email + "}]<br>2. Make changes to current User — set clickup_task_id = Step 1's task_id<br>3. Show alert: "Task created: " + Step 1's task_url<br>---<br>ERROR MESSAGES<br>- "Invalid token or insufficient permissions" → check your API token in Plugin Settings<br>- "List not found" → verify the list_id value<br>- "custom_fields_json is not valid JSON" → check JSON syntax, ensure all quotes and brackets are correct<br>- "Bad request" → check that status/priority/custom field values match ClickUp's expected formats<br>---<br>NOTES<br>- The API token is stored as a private server-side key and is never sent to the browser<br>- Tags must already exist in your ClickUp workspace to be applied correctly<br>- Dates must be provided in Unix milliseconds (not seconds)<br>- Custom field IDs are UUIDs — get them from the ClickUp API or your ClickUp AI agent