> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Clockwork Recruiting

> How to set up the Clockwork Recruiting connector, plus the actions that are available.

<div className="connector-page-header">
  <img src="https://stackone-logos.com/api/clockwork/filled/svg" alt="Clockwork Recruiting" className="connector-page-icon" />

  <div className="connector-page-changelog">
    <div className="connector-page-version"><span className="connector-page-tag-beta connector-page-stage-tag">Beta</span><span>v1.1.0</span></div>
    <div><a href="/connectors/clockwork/changelog">See changelog</a></div>
  </div>

  <div className="connector-page-header-meta">
    <div className="connector-page-subtitle"><a href="#actions">16 actions</a> · 1 auth method</div>

    <div className="connector-page-category-tags">
      <span className="connector-page-category-tag">ATS</span>
    </div>
  </div>
</div>

## Getting Started

<Steps>
  <Step title="Create or Select a Project">
    Set up a new project or select an existing one. See [Organizations & Projects](/gateway/concepts/organizations-and-projects).
  </Step>

  <Step title="Configure the Connector">
    Enable the connector and set up a Connector Profile in your project. See [Setup Connector Profile](/gateway/quickstart#setup-connector-profile).

    <Columns cols={2}>
      <Card title="Connector Profile · API Key" href="/connectors/clockwork/guides/connector-profile/api-key" icon="https://stackone-logos.com/api/clockwork/filled/svg" horizontal>
        Requires four credentials — API Key, API Secret, Firm Service Key, and your Firm Name (the subdomain in the API base pat...
      </Card>
    </Columns>
  </Step>

  <Step title="Link an Account">
    Link an account [from the dashboard](/connect/managing-connectors/linking-accounts#link-from-the-dashboard) (or via [StackOne Hub](/embed/account-linking/overview)).

    See the guide for the authentication type chosen in the Connector Profile:

    <Columns cols={2}>
      <Card title="Link Account · API Key" href="/connectors/clockwork/guides/link-account/api-key" icon="https://stackone-logos.com/api/clockwork/filled/svg" horizontal />
    </Columns>
  </Step>

  <Step title="Use Actions">
    Connect an AI platform to the linked account's actions. See [AI Platforms](/connect/ai-platforms/overview).

    Other ways to call actions are listed in [Protocols & SDKs](/connect/protocols-and-sdks).
  </Step>
</Steps>

## Actions

<div className="connector-meta-library-section">
  <div className="connector-actions-controls not-prose" data-connector-actions-controls>
    <div className="connector-actions-controls__row">
      <input type="search" className="connector-actions-search" data-connector-actions-search placeholder="Search actions" aria-label="Search actions" />
    </div>
  </div>

  <div className="meta-library-count" data-connector-actions-count>16 actions</div>

  <div className="not-prose meta-library-table-container" data-connector-actions-table>
    <div className="connector-meta-library-grid">
      <div className="connector-meta-library-row">
        <div className="meta-library-grid-header-cell">Action</div>
        <div className="meta-library-grid-header-cell">Description</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="clockwork_list_people" data-action-label="List People" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List People</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="clockwork_list_people" aria-label="Copy clockwork_list_people"><code className="connector-page-code">clockwork\_list\_people</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List the firm's people — candidates and contacts — with optional LinkedIn URL filter and sorting.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="clockwork_get_person" data-action-label="Get Person" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get Person</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="clockwork_get_person" aria-label="Copy clockwork_get_person"><code className="connector-page-code">clockwork\_get\_person</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Get a single person by ID, optionally embedding their preferred contact details, position and tags.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="clockwork_create_person" data-action-label="Create Person" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Create Person</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="clockwork_create_person" aria-label="Copy clockwork_create_person"><code className="connector-page-code">clockwork\_create\_person</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Create a person (candidate or contact) in the firm, optionally tagging them and setting custom field values.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="clockwork_update_person" data-action-label="Update Person" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Update Person</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="clockwork_update_person" aria-label="Copy clockwork_update_person"><code className="connector-page-code">clockwork\_update\_person</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Update a person's core record — name, biography, flags, tags, and which of their contact records are preferred.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="clockwork_delete_person" data-action-label="Delete Person" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Delete Person</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="clockwork_delete_person" aria-label="Copy clockwork_delete_person"><code className="connector-page-code">clockwork\_delete\_person</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Delete a person from the firm by ID.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="clockwork_search_people" data-action-label="Search People" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Search People</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="clockwork_search_people" aria-label="Copy clockwork_search_people"><code className="connector-page-code">clockwork\_search\_people</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Full-text search across the firm's people, with filters for date added, LinkedIn URL, and specific person IDs.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="clockwork_list_projects" data-action-label="List Projects" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List Projects</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="clockwork_list_projects" aria-label="Copy clockwork_list_projects"><code className="connector-page-code">clockwork\_list\_projects</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List the firm's search projects, optionally filtered by status, project type, or assigned user.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="clockwork_search_projects" data-action-label="Search Projects" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Search Projects</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="clockwork_search_projects" aria-label="Copy clockwork_search_projects"><code className="connector-page-code">clockwork\_search\_projects</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Find projects by their client company — fuzzy name, company ID, or company LinkedIn URL.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="clockwork_get_project" data-action-label="Get Project" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get Project</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="clockwork_get_project" aria-label="Copy clockwork_get_project"><code className="connector-page-code">clockwork\_get\_project</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Get a single search project by ID, optionally embedding client company, lead, owner and placement details.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="clockwork_list_candidacies" data-action-label="List Candidacies" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List Candidacies</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="clockwork_list_candidacies" aria-label="Copy clockwork_list_candidacies"><code className="connector-page-code">clockwork\_list\_candidacies</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List the candidacies on a search project — the people being considered for that role.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="clockwork_get_candidacy" data-action-label="Get Candidacy" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get Candidacy</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="clockwork_get_candidacy" aria-label="Copy clockwork_get_candidacy"><code className="connector-page-code">clockwork\_get\_candidacy</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Get a single candidacy on a project by ID, optionally embedding the person, project and its notes.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="clockwork_create_candidacy" data-action-label="Create Candidacy" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Create Candidacy</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="clockwork_create_candidacy" aria-label="Copy clockwork_create_candidacy"><code className="connector-page-code">clockwork\_create\_candidacy</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Add a person to a search project as a candidate.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="clockwork_update_candidacy" data-action-label="Update Candidacy" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Update Candidacy</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="clockwork_update_candidacy" aria-label="Copy clockwork_update_candidacy"><code className="connector-page-code">clockwork\_update\_candidacy</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Update a candidacy on a project — move its pipeline stage, reassign the recruiter, or change its flags.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="clockwork_delete_candidacy" data-action-label="Delete Candidacy" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Delete Candidacy</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="clockwork_delete_candidacy" aria-label="Copy clockwork_delete_candidacy"><code className="connector-page-code">clockwork\_delete\_candidacy</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Delete a candidacy from a project. Only candidacies with no notes attached can be deleted.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="clockwork_list_companies" data-action-label="List Companies" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List Companies</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="clockwork_list_companies" aria-label="Copy clockwork_list_companies"><code className="connector-page-code">clockwork\_list\_companies</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List the firm's companies, optionally filtered by name, do-not-contact flag, or client-company status.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="clockwork_get_company" data-action-label="Get Company" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get Company</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="clockwork_get_company" aria-label="Copy clockwork_get_company"><code className="connector-page-code">clockwork\_get\_company</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Get a single company by ID, optionally embedding its tags and logo.</div>
      </div>
    </div>
  </div>
</div>