Prerequisites
- An n8n instance, either self-hosted or n8n Cloud
- A Sellfern API key with the minimum scope required for the workflow
- Any destination credentials your workflow needs, such as a team messaging webhook
Create a Sellfern credential
In n8n, create a Header Auth credential for Sellfern.- Header name:
x-api-key - Header value: your Sellfern API key stored in n8n credentials
Add an HTTP Request node
Configure an HTTP Request node to call an endpoint from the V1 API Reference.- Method: choose the method shown in
/api-reference - URL: combine
https://api.sellfern.comwith the documented public path - Authentication: Header Auth credential using
x-api-key - Query/body: match the request parameters and schema shown in the API Reference
/api-reference, do not use it for a public integration. Ask the user to confirm endpoint availability in the API Reference first.
Writes and retries
For public write endpoints, add anIdempotency-Key header. Reuse the same value when retrying the same logical mutation after a timeout or uncertain server error.
Generate a new idempotency key for a different mutation.
Handling common errors
Recommended workflow pattern
- Start with the Sellfern documentation index at
https://docs.sellfern.com/llms.txt. - Read the relevant developer guide for authentication, scopes, errors, and idempotency.
- Confirm the endpoint in
/api-reference. - Build the n8n HTTP Request node with the scoped
x-api-keycredential. - Test the workflow manually before activating the schedule or trigger.
