# Verifly ChatGPT Action Setup

Use this guide when creating a Custom GPT or ChatGPT workflow that needs email verification, email list cleaning, or email extraction.

## Action Schema

Import this OpenAPI URL in the GPT Action builder:

https://verifly.email/chatgpt-action-openapi.json

## Authentication

Use API key or bearer-token authentication in the GPT Action settings.

- Header name: Authorization
- Header value format: Bearer vf_your_api_key
- Keep the API key in the GPT Action authentication settings.
- Do not paste API keys into GPT instructions, chat prompts, knowledge files, logs, screenshots, or examples.

## Suggested GPT Instructions

You can use Verifly when the user asks to verify an email address, validate signup emails, clean an email list, extract emails from text, check a CSV before import, or identify risky/disposable/invalid addresses.

Before calling Verifly, ask for confirmation if the user pasted a large list. For small lists, extract the emails and call the clean or batch verification action. After calling Verifly, summarize counts first: valid, invalid, risky, disposable, role account, catch-all, unknown, and any credits or errors returned by the API. Do not expose the API key.

## Action Selection

- Use verifyEmail for one email address.
- Use verifyEmailBatch for up to 100 email addresses.
- Use cleanEmailList when the user wants a usable/risky/invalid split.
- Use extractEmails when the user pasted unstructured text and needs addresses extracted first.

## Useful Links

- Product: https://verifly.email
- ChatGPT action page: https://verifly.email/chatgpt-email-verification
- OpenAPI for GPT Action: https://verifly.email/chatgpt-action-openapi.json
- Full OpenAPI: https://verifly.email/openapi.json
- Agent guide: https://verifly.email/agents
- Register for API key: https://verifly.email/register