> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.es/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Reset the password of an existing token.
> Permite la creación de una contraseña de reemplazo para un token determinado. Una vez que la contraseña se restablece correctamente, la contraseña anterior del token deja de ser válida.
export const ScopesList = ({scopes = [], description = "Esta API requiere uno de los siguientes ámbitos:"}) => {
if (!scopes || scopes.length === 0) {
return null;
}
const sortedScopes = scopes.sort((a, b) => a.localeCompare(b));
return
;
};
## OpenAPI
````yaml specs/legacy/v3/marketing-transactional-single-send-v3.json POST /marketing/v3/transactional/smtp-tokens/{tokenId}/password-reset
openapi: 3.0.1
info:
title: Envío de un solo correo transaccional
version: v3
x-hubspot-product-tier-requirements:
marketing: PROFESSIONAL
sales: FREE
service: FREE
cms: FREE
commerce: FREE
crmHub: FREE
dataHub: FREE
x-hubspot-api-use-case: >-
Después de que un cliente se convierta o compre un producto de tu empresa,
quieres enviarle un recibo de su transacción.
x-hubspot-related-documentation:
- name: Transactional Email Guide
url: >-
https://developers.hubspot.com/docs/guides/api/marketing/emails/transactional-emails
x-hubspot-introduction: >-
Utiliza la API de correos transaccionales para enviar correos desde una
dirección IP dedicada a tus contactos relacionados con transacciones
comerciales esenciales, como actualizaciones de cuentas o cambios en los
términos del servicio.
servers:
- url: https://api.hubapi.com
security: []
tags:
- name: Send transactional email
- name: SMTP Tokens
paths:
/marketing/v3/transactional/smtp-tokens/{tokenId}/password-reset:
post:
tags:
- SMTP Tokens
summary: Restablece la contraseña de un token existente.
description: >-
Permite la creación de una contraseña de reemplazo para un token
determinado. Una vez que la contraseña se restablece correctamente, la
contraseña anterior del token deja de ser válida.
operationId: >-
post-/marketing/v3/transactional/smtp-tokens/{tokenId}/password-reset_resetPassword
parameters:
- name: tokenId
in: path
description: Identificador generado cuando se crea un token.
required: true
style: simple
explode: false
schema:
type: string
responses:
'200':
description: successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/SmtpApiTokenView'
default:
$ref: '#/components/responses/Error'
description: ''
security:
- oauth2:
- transactional-email
components:
schemas:
SmtpApiTokenView:
required:
- campaignName
- createContact
- createdAt
- createdBy
- emailCampaignId
- id
type: object
properties:
campaignName:
type: string
description: Un nombre para la campaña vinculada al token.
createContact:
type: boolean
description: >-
Indica si se debe crear un registro de contacto para los
destinatarios de correo.
createdAt:
type: string
description: Marca de tiempo generada cuando se crea un token.
format: date-time
createdBy:
type: string
description: >-
Dirección de correo del usuario que envió la solicitud de creación
de token.
emailCampaignId:
type: string
description: >-
Identificador asignado a la campaña especificado en la solicitud de
creación de token.
id:
type: string
description: >-
Nombre de usuario para iniciar sesión en el servidor SMTP de
HubSpot.
password:
type: string
description: >-
Contraseña utilizada para iniciar sesión en el servidor SMTP de
HubSpot.
description: >-
A SMTP API token provides both an ID and password that can be used to
send email through the HubSpot SMTP API.
Error:
required:
- category
- correlationId
- message
type: object
properties:
category:
type: string
description: La categoría del error
context:
type: object
additionalProperties:
type: array
items:
type: string
description: Contexto de la condición de error
example: >-
{invalidPropertyName=[propertyValue], missingScopes=[scope1,
scope2]}
correlationId:
type: string
description: >-
Un identificador único para la solicitud. Incluye este valor con
cualquier informe de error o ticket de asistencia.
format: uuid
example: aeb5f871-7f07-4993-9211-075dc63e7cbf
errors:
type: array
description: información adicional acerca del error
items:
$ref: '#/components/schemas/ErrorDetail'
links:
type: object
additionalProperties:
type: string
description: >-
Un mapa de nombres de enlaces a las URI asociadas que contienen
documentación sobre el error o los pasos recomendados para
solucionarlo
message:
type: string
description: >-
Un mensaje legible en el que se describa el error y los pasos para
solucionarlo, si procede
example: An error occurred
subCategory:
type: string
description: >-
Una categoría específica que contiene detalles más concretos acerca
del error
example:
message: Invalid input (details will vary based on the error)
correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf
category: VALIDATION_ERROR
links:
knowledge-base: https://www.hubspot.com/products/service/knowledge-base
ErrorDetail:
required:
- message
type: object
properties:
code:
type: string
description: El código de estado asociado al detalle del error
context:
type: object
additionalProperties:
type: array
items:
type: string
description: Contexto de la condición de error
example: '{missingScopes=[scope1, scope2]}'
in:
type: string
description: El nombre del campo o parámetro en el que se encontró el error.
message:
type: string
description: >-
Un mensaje legible en el que se describa el error y los pasos para
solucionarlo, si procede
subCategory:
type: string
description: >-
Una categoría específica que contiene detalles más concretos acerca
del error
responses:
Error:
description: An error occurred.
content:
'*/*':
schema:
$ref: '#/components/schemas/Error'
securitySchemes:
oauth2:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://app.hubspot.com/oauth/authorize
tokenUrl: https://api.hubapi.com/oauth/v1/token
scopes:
transactional-email: ''
````
{product.name} -
{product.level}
)}