feat(ashby): add 15 new tools and fix existing tool accuracy (#3662)

* feat(ashby): add 15 new tools and fix existing tool accuracy

* fix(ashby): fix response field mappings for changeStage and createNote

* fix(ashby): fix websiteUrl field name in candidate.update request

* fix(ashby): revert body field names to candidateId and jobId for info endpoints

* fix(ashby): add subblock ID migrations for removed emailType and phoneType

* fix(ashby): map removed emailType/phoneType to dummy keys to avoid data corruption

Author: waleedlatif1

apps/sim/blocks/blocks/ashby.ts

@@ -23,6 +23,10 @@ export const SUBBLOCK_ID_MIGRATIONS: Record<string, Record<string, string>> = {
   knowledge: {
     knowledgeBaseId: 'knowledgeBaseSelector',
   },
+  ashby: {
+    emailType: '_removed_emailType',
+    phoneType: '_removed_phoneType',
+  },
 }
 
 /**

apps/sim/lib/workflows/migrations/subblock-migrations.ts

@@ -0,0 +1,76 @@
+import type { ToolConfig, ToolResponse } from '@/tools/types'
+
+interface AshbyAddCandidateTagParams {
+  apiKey: string
+  candidateId: string
+  tagId: string
+}
+
+interface AshbyAddCandidateTagResponse extends ToolResponse {
+  output: {
+    success: boolean
+  }
+}
+
+export const addCandidateTagTool: ToolConfig<
+  AshbyAddCandidateTagParams,
+  AshbyAddCandidateTagResponse
+> = {
+  id: 'ashby_add_candidate_tag',
+  name: 'Ashby Add Candidate Tag',
+  description: 'Adds a tag to a candidate in Ashby.',
+  version: '1.0.0',
+
+  params: {
+    apiKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Ashby API Key',
+    },
+    candidateId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'The UUID of the candidate to add the tag to',
+    },
+    tagId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'The UUID of the tag to add',
+    },
+  },
+
+  request: {
+    url: 'https://api.ashbyhq.com/candidate.addTag',
+    method: 'POST',
+    headers: (params) => ({
+      'Content-Type': 'application/json',
+      Authorization: `Basic ${btoa(`${params.apiKey}:`)}`,
+    }),
+    body: (params) => ({
+      candidateId: params.candidateId,
+      tagId: params.tagId,
+    }),
+  },
+
+  transformResponse: async (response: Response) => {
+    const data = await response.json()
+
+    if (!data.success) {
+      throw new Error(data.errorInfo?.message || 'Failed to add tag to candidate')
+    }
+
+    return {
+      success: true,
+      output: {
+        success: true,
+      },
+    }
+  },
+
+  outputs: {
+    success: { type: 'boolean', description: 'Whether the tag was successfully added' },
+  },
+}

apps/sim/tools/ashby/add_candidate_tag.ts

@@ -0,0 +1,94 @@
+import type { ToolConfig, ToolResponse } from '@/tools/types'
+
+interface AshbyChangeApplicationStageParams {
+  apiKey: string
+  applicationId: string
+  interviewStageId: string
+  archiveReasonId?: string
+}
+
+interface AshbyChangeApplicationStageResponse extends ToolResponse {
+  output: {
+    applicationId: string
+    stageId: string | null
+  }
+}
+
+export const changeApplicationStageTool: ToolConfig<
+  AshbyChangeApplicationStageParams,
+  AshbyChangeApplicationStageResponse
+> = {
+  id: 'ashby_change_application_stage',
+  name: 'Ashby Change Application Stage',
+  description:
+    'Moves an application to a different interview stage. Requires an archive reason when moving to an Archived stage.',
+  version: '1.0.0',
+
+  params: {
+    apiKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Ashby API Key',
+    },
+    applicationId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'The UUID of the application to update the stage of',
+    },
+    interviewStageId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'The UUID of the interview stage to move the application to',
+    },
+    archiveReasonId: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description:
+        'Archive reason UUID. Required when moving to an Archived stage, ignored otherwise',
+    },
+  },
+
+  request: {
+    url: 'https://api.ashbyhq.com/application.changeStage',
+    method: 'POST',
+    headers: (params) => ({
+      'Content-Type': 'application/json',
+      Authorization: `Basic ${btoa(`${params.apiKey}:`)}`,
+    }),
+    body: (params) => {
+      const body: Record<string, unknown> = {
+        applicationId: params.applicationId,
+        interviewStageId: params.interviewStageId,
+      }
+      if (params.archiveReasonId) body.archiveReasonId = params.archiveReasonId
+      return body
+    },
+  },
+
+  transformResponse: async (response: Response) => {
+    const data = await response.json()
+
+    if (!data.success) {
+      throw new Error(data.errorInfo?.message || 'Failed to change application stage')
+    }
+
+    const r = data.results
+
+    return {
+      success: true,
+      output: {
+        applicationId: r.id ?? null,
+        stageId: r.currentInterviewStage?.id ?? null,
+      },
+    }
+  },
+
+  outputs: {
+    applicationId: { type: 'string', description: 'Application UUID' },
+    stageId: { type: 'string', description: 'New interview stage UUID' },
+  },
+}

apps/sim/tools/ashby/change_application_stage.ts

@@ -13,27 +13,7 @@ interface AshbyCreateApplicationParams {
 
 interface AshbyCreateApplicationResponse extends ToolResponse {
   output: {
-    id: string
-    status: string
-    candidate: {
-      id: string
-      name: string
-    }
-    job: {
-      id: string
-      title: string
-    }
-    currentInterviewStage: {
-      id: string
-      title: string
-      type: string
-    } | null
-    source: {
-      id: string
-      title: string
-    } | null
-    createdAt: string
-    updatedAt: string
+    applicationId: string
   }
 }
 
@@ -132,74 +112,12 @@ export const createApplicationTool: ToolConfig<
     return {
       success: true,
       output: {
-        id: r.id ?? null,
-        status: r.status ?? null,
-        candidate: {
-          id: r.candidate?.id ?? null,
-          name: r.candidate?.name ?? null,
-        },
-        job: {
-          id: r.job?.id ?? null,
-          title: r.job?.title ?? null,
-        },
-        currentInterviewStage: r.currentInterviewStage
-          ? {
-              id: r.currentInterviewStage.id ?? null,
-              title: r.currentInterviewStage.title ?? null,
-              type: r.currentInterviewStage.type ?? null,
-            }
-          : null,
-        source: r.source
-          ? {
-              id: r.source.id ?? null,
-              title: r.source.title ?? null,
-            }
-          : null,
-        createdAt: r.createdAt ?? null,
-        updatedAt: r.updatedAt ?? null,
+        applicationId: r.applicationId ?? null,
       },
     }
   },
 
   outputs: {
-    id: { type: 'string', description: 'Created application UUID' },
-    status: { type: 'string', description: 'Application status (Active, Hired, Archived, Lead)' },
-    candidate: {
-      type: 'object',
-      description: 'Associated candidate',
-      properties: {
-        id: { type: 'string', description: 'Candidate UUID' },
-        name: { type: 'string', description: 'Candidate name' },
-      },
-    },
-    job: {
-      type: 'object',
-      description: 'Associated job',
-      properties: {
-        id: { type: 'string', description: 'Job UUID' },
-        title: { type: 'string', description: 'Job title' },
-      },
-    },
-    currentInterviewStage: {
-      type: 'object',
-      description: 'Current interview stage',
-      optional: true,
-      properties: {
-        id: { type: 'string', description: 'Stage UUID' },
-        title: { type: 'string', description: 'Stage title' },
-        type: { type: 'string', description: 'Stage type' },
-      },
-    },
-    source: {
-      type: 'object',
-      description: 'Application source',
-      optional: true,
-      properties: {
-        id: { type: 'string', description: 'Source UUID' },
-        title: { type: 'string', description: 'Source title' },
-      },
-    },
-    createdAt: { type: 'string', description: 'ISO 8601 creation timestamp' },
-    updatedAt: { type: 'string', description: 'ISO 8601 last update timestamp' },
+    applicationId: { type: 'string', description: 'Created application UUID' },
   },
 }

apps/sim/tools/ashby/create_application.ts

@@ -25,28 +25,16 @@ export const createCandidateTool: ToolConfig<
     },
     email: {
       type: 'string',
-      required: false,
+      required: true,
       visibility: 'user-or-llm',
       description: 'Primary email address for the candidate',
     },
-    emailType: {
-      type: 'string',
-      required: false,
-      visibility: 'user-or-llm',
-      description: 'Email address type: Personal, Work, or Other (default Work)',
-    },
     phoneNumber: {
       type: 'string',
       required: false,
       visibility: 'user-or-llm',
       description: 'Primary phone number for the candidate',
     },
-    phoneType: {
-      type: 'string',
-      required: false,
-      visibility: 'user-or-llm',
-      description: 'Phone number type: Personal, Work, or Other (default Work)',
-    },
     linkedInUrl: {
       type: 'string',
       required: false,
@@ -77,27 +65,11 @@ export const createCandidateTool: ToolConfig<
     body: (params) => {
       const body: Record<string, unknown> = {
         name: params.name,
+        email: params.email,
       }
-      if (params.email) {
-        body.primaryEmailAddress = {
-          value: params.email,
-          type: params.emailType || 'Work',
-          isPrimary: true,
-        }
-      }
-      if (params.phoneNumber) {
-        body.primaryPhoneNumber = {
-          value: params.phoneNumber,
-          type: params.phoneType || 'Work',
-          isPrimary: true,
-        }
-      }
-      if (params.linkedInUrl || params.githubUrl) {
-        const socialLinks: Array<{ url: string; type: string }> = []
-        if (params.linkedInUrl) socialLinks.push({ url: params.linkedInUrl, type: 'LinkedIn' })
-        if (params.githubUrl) socialLinks.push({ url: params.githubUrl, type: 'GitHub' })
-        body.socialLinks = socialLinks
-      }
+      if (params.phoneNumber) body.phoneNumber = params.phoneNumber
+      if (params.linkedInUrl) body.linkedInUrl = params.linkedInUrl
+      if (params.githubUrl) body.githubUrl = params.githubUrl
       if (params.sourceId) body.sourceId = params.sourceId
       return body
     },

apps/sim/tools/ashby/create_candidate.ts

@@ -78,35 +78,12 @@ export const createNoteTool: ToolConfig<AshbyCreateNoteParams, AshbyCreateNoteRe
     return {
       success: true,
       output: {
-        id: r.id ?? null,
-        content: r.content ?? null,
-        author: r.author
-          ? {
-              id: r.author.id ?? null,
-              firstName: r.author.firstName ?? null,
-              lastName: r.author.lastName ?? null,
-              email: r.author.email ?? null,
-            }
-          : null,
-        createdAt: r.createdAt ?? null,
+        noteId: r.id ?? null,
       },
     }
   },
 
   outputs: {
-    id: { type: 'string', description: 'Created note UUID' },
-    content: { type: 'string', description: 'Note content as stored' },
-    author: {
-      type: 'object',
-      description: 'Note author',
-      optional: true,
-      properties: {
-        id: { type: 'string', description: 'Author user UUID' },
-        firstName: { type: 'string', description: 'First name' },
-        lastName: { type: 'string', description: 'Last name' },
-        email: { type: 'string', description: 'Email address' },
-      },
-    },
-    createdAt: { type: 'string', description: 'ISO 8601 creation timestamp' },
+    noteId: { type: 'string', description: 'Created note UUID' },
   },
 }

apps/sim/tools/ashby/create_note.ts

@@ -30,7 +30,7 @@ export const getCandidateTool: ToolConfig<AshbyGetCandidateParams, AshbyGetCandi
       Authorization: `Basic ${btoa(`${params.apiKey}:`)}`,
     }),
     body: (params) => ({
-      candidateId: params.candidateId,
+      candidateId: params.candidateId.trim(),
     }),
   },