---
title: "Ashby"
description: "Trae a Pyn a los candidatos contratados en Ashby como próximas incorporaciones, para que los flows de pre-boarding puedan empezar antes del primer día."
sidebar:
  label: Resumen
  order: 0
area: integrations
feature: ashby
appPath: /settings/integrations/available
lastVerified: 2026-11-15
version: "2026-11-03"
audience: admin
related:
  - integrations
  - integrations/greenhouse
  - integrations/sync-and-matching
  - flows/automations
translation:
  source: integrations/ashby/index.mdx
  sourceSha: d7b66f45596ed73fca1ddce214dfa31498448362
---

La integración con Ashby lee los candidatos con una candidatura contratada y una oferta vigente con fecha de inicio (se prefiere una oferta aceptada) y los crea como próximas incorporaciones, con su fecha de inicio, puesto, departamento, ubicación y hiring manager. Un flow de pre-boarding disparado por la fecha de inicio puede entonces escribirles a una dirección personal antes de que exista su cuenta de trabajo.

## Antes de empezar

- Eres administrador o propietario en Pyn.
- Un administrador de Ashby crea una clave de API en **Admin > API Keys** con acceso de lectura a **Candidates**, **Offers** y **Organization**. El acceso de lectura a **Jobs** es opcional y recoge el hiring manager definido en el puesto en lugar del de la candidatura. Para incluir contrataciones de puestos confidenciales, permite también el acceso a puestos y proyectos confidenciales.

![Connect to Ashby asks for an API Key.](https://support.pyn.ai/media/integrations/ashby/integrations-ashby-connect.png)

## Conecta

1. En Pyn, abre **Settings** en la navegación izquierda y después **Available** bajo **Integrations**.

2. Selecciona el mosaico **Ashby**. Se abre el diálogo **Connect to Ashby**.

3. Pega la **API Key**.

4. Selecciona **Connect**. El diálogo muestra "Validating that API key..." mientras Pyn la comprueba.

5. Si todo va bien, un aviso dice "Your Ashby integration has been added to Pyn. It will take a minute or two for candidate data to be pulled from Ashby."

Errores que puede mostrar el diálogo: "Could not verify that API key — it appears to be invalid or deactivated." / "The API key is valid but lacks the permissions needed. Grant it read access to Candidates, Offers and Organization and try again." / "Enter an Ashby API key." / "An unexpected error occurred. Please check the API key and try again. If the error persists, contact support."

## Qué se sincroniza

Pyn actualiza desde Ashby aproximadamente una vez por hora. De cada candidatura contratada lee:

| Propiedad en Pyn | Desde Ashby |
| --- | --- |
| Nombre para mostrar, nombre legal | El nombre del candidato |
| Correo de trabajo, correo personal | Los correos de contacto de trabajo y personal del candidato |
| Fecha de inicio | La fecha de inicio de la última versión de la oferta |
| Puesto | El puesto de la candidatura |
| Departamento, ubicación | Los nombres del departamento y la ubicación del puesto |
| Manager | El hiring manager del puesto (un usuario de Ashby) |
| Zona horaria | La zona horaria del candidato |
| Campos personalizados | Cualquier extensión del workspace mapeada a un campo personalizado de Ashby, leída de la oferta, después de la candidatura y después del candidato |

Las contrataciones aparecen en el Directory como **Upcoming** hasta su fecha de inicio. Consulta [Cadencia de sincronización y emparejamiento](https://support.pyn.ai/es/integrations/sync-and-matching/) para saber cómo se emparejan con el registro del HRIS que llega después.

## Pruébalo

Tras la primera actualización, abre [Employees](https://support.pyn.ai/es/directory/employees/) y selecciona la vista **Upcoming**: las contrataciones recientes deberían aparecer con su fecha de inicio. La pestaña **History** de la integración muestra cada actualización.

## Reconecta o desconecta

- **Reconnect**, en el menú **...**, abre **Reconnect to Ashby** para pegar una clave nueva. "Your Ashby integration has been updated." lo confirma.
- **Deactivate** pausa la sincronización; **Activate** la reanuda.

## Solución de problemas

| Qué ves | Qué significa |
| --- | --- |
| History: "Error: Authentication failed, please reconnect" | La clave se desactivó en Ashby. Crea una nueva y reconecta. |
| History: "Error: Insufficient Ashby permissions" | A la clave le falta un alcance de lectura. Concede Candidates, Offers y Organization. |
| Falta una contratación | La oferta se rechazó, se canceló o se retiró, no tiene fecha de inicio, o el puesto es confidencial y la clave no puede verlo. |
| El hiring manager está en blanco | Concede acceso de lectura a Jobs, o define el hiring manager en la candidatura. |

## Relacionado

- [Integrations](https://support.pyn.ai/es/integrations/) para el catálogo.
- [Greenhouse](https://support.pyn.ai/es/integrations/greenhouse/) para la otra integración con un ATS.
- [Cadencia de sincronización y emparejamiento](https://support.pyn.ai/es/integrations/sync-and-matching/) para saber cómo se fusionan los registros del ATS y del HRIS.
- [Automations](https://support.pyn.ai/es/flows/automations/) para construir un flow de pre-boarding basado en la fecha de inicio.
