CheddahBot/docs/clickup-task-creation.md

1.8 KiB

ClickUp Task Creation

CLI Script

uv run python scripts/create_clickup_task.py --name "LINKS - keyword" --client "Client Name" \
    --category "Link Building" --due-date 2026-03-18 --tag mar26 --time-estimate 2h \
    --field "Keyword=keyword" --field "IMSURL=https://example.com" --field "LB Method=Cora Backlinks"

Defaults

  • Priority: High (2)
  • Assignee: Bryan (10765627)
  • Status: "to do"
  • Due date format: YYYY-MM-DD
  • Tag format: mmmYY (e.g. feb26, mar26)

Custom Fields

Any field can be set via --field "Name=Value". Dropdowns are auto-resolved by name (case-insensitive).

Task Types

  • Prefix: LINKS - {keyword}
  • Work Category: "Link Building"
  • Required fields: Keyword, IMSURL
  • LB Method: default "Cora Backlinks"
  • CLIFlags: only add --tier1-count N when count is specified
  • BrandedPlusRatio: default to 0.7
  • CustomAnchors: only if given a list of custom anchors
  • time estimate: 2.5h

On Page Optimization

  • Prefix: OPT - {keyword}
  • Work Category: "On Page Optimization"
  • Required fields: Keyword, IMSURL
  • time estimate: 3h

Content Creation

  • Prefix: CREATE - {keyword}
  • Work Category: "Content Creation"
  • Required fields: Keyword
  • time estimate: 4h

Press Release

  • Prefix: PR - {keyword}
  • Required fields: Keyword, IMSURL
  • Work Category: "Press Release"
  • PR Topic: if not provided, ask if there is a topic. it can be blank if they respond with none.
  • time estimate: 1.5h

Chat Tool

The clickup_create_task tool provides the same capabilities via CheddahBot UI. Arbitrary custom fields are passed as JSON via custom_fields_json.

Client Folder Lookup

Tasks are created in the "Overall" list inside the client's folder. Folder name is matched case-insensitively.