Skip to main content
GET
/
crm
/
v3
/
pipelines
/
{objectType}
/
{pipelineId}
/
stages
/
{stageId}
Devolver una etapa de pipeline por ID
curl --request GET \
  --url https://api.hubapi.com/crm/v3/pipelines/{objectType}/{pipelineId}/stages/{stageId} \
  --header 'Authorization: Bearer <token>'
{
  "label": "In Progress",
  "displayOrder": 0,
  "metadata": {
    "ticketState": "OPEN"
  },
  "createdAt": "2019-10-30T03:30:17.883Z",
  "updatedAt": "2019-12-07T16:50:06.678Z",
  "archived": false,
  "id": "1234912"
}

Productos compatibles

Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing Hub -Gratuito
Sales HubSales Hub -Gratuito
Service HubService Hub -Gratuito
Content HubContent Hub -Starter
Esta API requiere uno de los siguientes ámbitos:
automation
crm.objects.appointments.read
crm.objects.appointments.sensitive.read.v2
crm.objects.appointments.sensitive.write.v2
crm.objects.appointments.write
crm.objects.carts.read
crm.objects.commercepayments.write
crm.objects.companies.highly_sensitive.read.v2
crm.objects.companies.highly_sensitive.write.v2
crm.objects.companies.read
crm.objects.companies.sensitive.read.v2
crm.objects.companies.sensitive.write.v2
crm.objects.companies.write
crm.objects.contacts.highly_sensitive.read.v2
crm.objects.contacts.highly_sensitive.write.v2
crm.objects.contacts.read
crm.objects.contacts.sensitive.read.v2
crm.objects.contacts.sensitive.write.v2
crm.objects.contacts.write
crm.objects.courses.read
crm.objects.courses.write
crm.objects.custom.highly_sensitive.read.v2
crm.objects.custom.highly_sensitive.write.v2
crm.objects.custom.read
crm.objects.custom.sensitive.read.v2
crm.objects.custom.sensitive.write.v2
crm.objects.custom.write
crm.objects.deals.highly_sensitive.read.v2
crm.objects.deals.highly_sensitive.write.v2
crm.objects.deals.read
crm.objects.deals.sensitive.read.v2
crm.objects.deals.sensitive.write.v2
crm.objects.deals.write
crm.objects.feedback_submissions.read
crm.objects.goals.read
crm.objects.goals.write
crm.objects.invoices.read
crm.objects.invoices.write
crm.objects.leads.read
crm.objects.leads.write
crm.objects.line_items.read
crm.objects.line_items.write
crm.objects.listings.read
crm.objects.listings.write
crm.objects.marketing_events.read
crm.objects.marketing_events.write
crm.objects.orders.read
crm.objects.owners.read
crm.objects.products.write
crm.objects.quotes.read
crm.objects.quotes.write
crm.objects.services.read
crm.objects.services.write
crm.objects.subscriptions.read
crm.objects.subscriptions.write
crm.objects.users.read
crm.pipelines.orders.read
crm.schemas.appointments.read
crm.schemas.carts.read
crm.schemas.commercepayments.read
crm.schemas.companies.read
crm.schemas.contacts.read
crm.schemas.courses.read
crm.schemas.custom.read
crm.schemas.deals.read
crm.schemas.invoices.read
crm.schemas.line_items.read
crm.schemas.listings.read
crm.schemas.orders.read
crm.schemas.quotes.read
crm.schemas.services.read
crm.schemas.subscriptions.read
e-commerce
media_bridge.read
tickets
tickets.highly_sensitive.v2
tickets.sensitive.v2
timeline

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
objectType
string
required
​
pipelineId
string
required
​
stageId
string
required

Response

successful operation

A pipeline stage definition.

​
createdAt
string<date-time>
required

La fecha en que se creó la etapa de pipeline. Las etapas de los pipelines predeterminados tendrán createdAt = 0.

​
archived
boolean
required

Whether the pipeline is archived.

​
metadata
object
required

Un objeto JSON que contiene propiedades que no están presentes en todos los pipelines de objetos.

Para los pipelines de "negocios", el campo "probabilidad" es obligatorio ("{ "probability": 0.5 }"), y representa la probabilidad de que un negocio se cierre. Los valores posibles están entre 0.0 y 1.0 en incrementos de 0.1.

Para los pipelines de "tickets", el campo "ticketState" es opcional ("{ "ticketState": "OPEN" }"), y representa si el ticket permanece abierto o si ha sido cerrado por un miembro de tu equipo de Asistencia técnica. Los valores posibles son "ABIERTO" o "CERRADO".

​
displayOrder
integer
required

El orden en que se mostrará esta etapa de pipeline. Si dos etapas de pipeline tienen un "displayOrder" coincidente, se ordenarán alfabéticamente según la etiqueta.

​
label
string
required

Una etiqueta que se utiliza para organizar las etapas de pipeline en la UI de HubSpot. Cada etiqueta de etapa de pipeline debe ser única dentro de ese pipeline.

​
id
string
required

Un identificador único generado por HubSpot que se puede utilizar para recuperar y actualizar la etapa de pipeline.

​
updatedAt
string<date-time>
required

La fecha en que se actualizó por última vez la etapa de pipeline.

​
archivedAt
string<date-time>

La fecha en que se archivó el pipeline. "archivedAt" solo estará presente si se archiva el pipeline.

​
writePermissions
enum<string>

Define el nivel de acceso de escritura para la etapa del pipeline, y los valores posibles son CRM_PERMISSIONS_ENFORCEMENT, READ_ONLY o INTERNAL_ONLY.

Available options:
CRM_PERMISSIONS_ENFORCEMENT,
READ_ONLY,
INTERNAL_ONLY