Credential

O bloco Credential entrega a um block seguinte uma credencial OAuth para usar, sem expor o segredo. Ele tem duas operações: Select Credential devolve a referência de ID de uma credencial para outros blocks usarem; List Credentials devolve todas as credenciais OAuth do workspace (opcionalmente filtradas por provedor) como um array para você iterar.

O bloco Credential devolve referências de ID de credenciais, não segredos. Os blocks seguintes recebem o ID e resolvem o token OAuth real de forma segura durante a própria execução.

Configuração

Operation

Valor	Descrição
Select Credential	Escolhe uma credencial OAuth e devolve a referência dela — use para conectar uma única credencial aos blocks seguintes
List Credentials	Devolve todas as credenciais OAuth do workspace como um array — use com um loop ForEach

Credential (operação Select)

Selecione uma credencial OAuth do seu workspace. O dropdown mostra todas as contas OAuth conectadas (Google, GitHub, Slack, etc.).

No advanced mode, cole um ID de credencial diretamente. Você pode copiar um ID de credencial na página de configurações Credentials do seu workspace.

Provider (operação List)

Filtre as credenciais OAuth devolvidas por provedor. Selecione um ou mais provedores no dropdown — apenas provedores para os quais você tem credenciais aparecem. Deixe vazio para devolver todas as credenciais OAuth.

Exemplo	Devolve
Gmail	Apenas credenciais do Gmail
Slack	Apenas credenciais do Slack
Gmail + Slack	Credenciais do Gmail e do Slack

Saídas

Saída	Tipo	Descrição
`credentialId`	`string`	O ID da credencial — passe isso para os campos de credencial de outros blocks
`displayName`	`string`	Nome legível (ex.: "waleed@company.com")
`providerId`	`string`	ID do provedor OAuth (ex.: `google-email`, `slack`)

Saída	Tipo	Descrição
`credentials`	`json`	Array de objetos de credencial OAuth (veja o formato abaixo)
`count`	`number`	Quantidade de credenciais devolvidas

Cada objeto do array credentials:

Campo	Tipo	Descrição
`credentialId`	`string`	O ID da credencial
`displayName`	`string`	Nome legível
`providerId`	`string`	ID do provedor OAuth

Exemplos

Compartilhar uma credencial entre blocks

Selecione uma conta Google uma vez e depois referencie <credential.credentialId> nos blocks Gmail, Drive e Calendar. Troque a conta em um lugar só e todos os blocks acompanham.

Rotear para uma conta diferente por lógica

Um Condition escolhe a credencial de produção ou de staging a partir de uma variável do workflow, e o bloco Slack seguinte publica com a que foi executada.

Listar todas as contas e distribuir o trabalho

Credential (List, Provider: Gmail) → ForEach Loop → Gmail (Send) using <loop.currentItem.credentialId>

Como conectar um bloco Credential

Select Credential

Solte um block Credential e selecione sua credencial OAuth no seletor
No block seguinte, mude o campo de credencial para o advanced mode
Informe <credentialBlockName.credentialId> como valor

A mesma referência funciona em qualquer block OAuth. No campo de credencial de um block Gmail ou Slack (em advanced mode), informe <myCredential.credentialId>.

List Credentials

Solte um block Credential e defina Operation como List Credentials
Opcionalmente, selecione um ou mais Providers para reduzir os resultados (apenas provedores conectados aparecem)
Conecte <credentialBlockName.credentials> a um ForEach Loop como fonte dos itens
Dentro do loop, referencie <loop.currentItem.credentialId> nos campos de credencial dos blocks seguintes

Boas práticas

Defina uma vez, referencie muitas vezes: quando cinco blocks usam a mesma conta Google, use um bloco Credential e conecte todos os cinco a <credential.credentialId> em vez de selecionar a conta cinco vezes
As saídas são seguras para logar: a saída credentialId é uma referência UUID, não um segredo. É seguro inspecioná-la nos logs de execução
Use para trocar de ambiente: combine com um bloco Condition para rotear para uma credencial OAuth de produção ou de staging com base em uma variável do workflow
O advanced mode é obrigatório: os blocks seguintes precisam estar em advanced mode no campo de credencial para aceitar uma referência dinâmica
Use List + ForEach para distribuir o trabalho: quando você precisa executar a mesma ação em todas as contas de um provedor, o List Credentials alimenta naturalmente um loop ForEach
Restrinja por provedor: use o multiselect de Provider para filtrar serviços específicos — apenas provedores para os quais você tem credenciais são exibidos

Common Questions

Não. O block devolve um ID de credencial (um UUID), não o token OAuth real. Os blocks seguintes recebem o ID e resolvem o token de forma segura no próprio contexto de execução. Os segredos nunca aparecem no estado do workflow, nos logs ou no workflow builder.

Apenas contas conectadas por OAuth (Google, GitHub, Slack, etc.). Variáveis de ambiente e service accounts não podem ser resolvidas por ID nos blocks seguintes, então não são suportadas.

Funcionalmente é idêntico — ambos passam o mesmo ID de credencial ao block seguinte. O bloco Credential ganha valor quando você precisa usar uma credencial em vários blocks (para trocá-la em um só lugar), ou quando quer escolher entre credenciais dinamicamente com um bloco Condition.

Sim. Defina Operation como 'List Credentials'. Opcionalmente, filtre por provedor com o multiselect de Provider. Conecte a saída credentials a um loop ForEach para processar cada credencial individualmente.

Sim. Referencie <credential.credentialId> no código do seu bloco Function. Note que a função vai receber a string UUID crua — se você precisa do token resolvido, o block seguinte precisa fazer essa resolução (como os blocks de integração fazem). O bloco Function não resolve IDs de credencial automaticamente.

A operação Select lança um erro em tempo de execução: 'Credential not found'. A operação List simplesmente omite a credencial excluída dos resultados. Atualize o bloco Credential para selecionar uma credencial válida antes de executar de novo.

Credential

Common Questions

Nesta página