ashby

ashby

ashby.

List candidates (paginated). Returns {results, moreDataAvailable,

ajouter à otoauth : —prefix : ashby_*

setup & usage

⚠ ta clé api ashby

il te faut une clé api ashby.

  • dans ashby, va dans admin → integrations → API et crée une clé
  • colle-la dans tes clés de connecteurs (ou laisse ton org partager la sienne)
  • doc éditeur : ashbyhq.com
  • ▸ ce que tu peux faire

    pilote ton ats ashby : candidats, jobs, candidatures, notes.

  • « trouve le candidat dont l'email est x@y.com » → ashby_search_candidates (par email et/ou name)
  • « liste les candidats » → ashby_candidates, puis le détail → ashby_candidate
  • « ajoute une note sur ce candidat » → ashby_add_note
  • « quels jobs sont ouverts ? » → ashby_jobs (status Open/Closed/Draft/Archived) ; les candidatures → ashby_applications (filtre job_id)
  • ⚙ plusieurs comptes

    ce connecteur accepte plusieurs comptes : chaque credential posé devient un compte nommé (un nom par compte), à ton niveau, à celui de ton équipe ou de ton org.

  • le premier n'a pas besoin de nom ; à partir du deuxième, chacun porte le sien (le premier prend alors le nom « principal », renommable)
  • sans précision, l'agent prend le seul compte posé, sinon celui marqué par défaut ; sinon l'appel est refusé en nommant les comptes disponibles — jamais un choix au hasard
  • viser un compte pour un appel : _account="<nom>" sur l'outil ; les lister : oto_identity(op='list', connector='ashby') (scope='org' ou scope='group' pour ceux de l'org ou de l'équipe)
  • fixer le défaut : oto_identity(op='set', connector='ashby', identity_id='<nom>') ; renommer : op='rename' avec new_name
  • ⚠️ aucun outil ne parcourt les comptes tout seul : un total sur plusieurs comptes s'obtient en appelant chacun (_account) et en additionnant
  • outils

    chargement…

    utilisation

    claude code — installe le plugin oto — claude plugin marketplace add otomata-tech/oto-plugin — mcp + skill configurés.
    claude.ai — branche mcp.oto.cx/mcp en connecteur custom (guide)
    cli — pipx install oto-cli puis oto ashby …