Whats Credential to connect with in the Puppeteer node

wizi · September 2, 2025, 11:21pm

I’m having an issue with puppeteer, where at the top it’s asking for Credential to connect with
Can someone please explain, what is it? what creds do I need for this to work?

jabbson · September 2, 2025, 11:54pm

Hey @wizi hope all is good. Welcome to the community.

Which node are you using?

jabbson · September 3, 2025, 2:25am

Ah I see now, you are probably using n8n-nodes-puppeteer-extended.
If this is the case, here is the what the credentials are and why it needs it.

Short version: this is n8n api key that the node is looking to be configured.

Long version:

It all starts in Puppeteer.node.ts where the node attempts to read credentials n8nApi:

github.com/edbrdi/n8n-nodes-puppeteer-extended

nodes/Puppeteer/Puppeteer.node.ts

main


      
          					});
          				}
          
          				return returnData;
          			},
          		},
          	};
          
          	async execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]> {
          		let returnData: INodeExecutionData[] = [];
          		const credentials = (await this.getCredentials("n8nApi")) as {
          			apiKey: string;
          			baseUrl: string;
          		};
          		// @ts-ignore
          		const executionId = this.getExecutionId();
          
          		const globalOptions = this.getNodeParameter(
          			"globalOptions",
          			0,
          			{}

Then the credentials are passed into ipcRequest inthe same file

        ipcRequest("check", {
			executionId,
			apiKey: credentials.apiKey,
			baseUrl: credentials.baseUrl,
		});

This function is defined in helpers.ts:

github.com/edbrdi/n8n-nodes-puppeteer-extended

nodes/Puppeteer/puppeteer/helpers.ts

main


      
          	interactions: {
          		parameter: {
          			selector: string;
          			value?: string;
          			waitForNavigation?: boolean;
          		}[];
          	};
          }
          
          // todo timeout
          export const ipcRequest = (type: string, parameters: any): Promise<any> => {
          	return new Promise((resolve) => {
          		ipc.config.retry = 1500;
          		ipc.connectTo("puppeteer", () => {
          			ipc.of.puppeteer.emit(type, parameters);
          
          			ipc.of.puppeteer.on(type, (data: any) => {
          				resolve(data);
          			});
          		});
          	});

So far not really clear why it needs it. Keep going…

We’ve seen that the credentials are passed to ipcRequest for the check event. This event is coded in index.ts:

github.com/edbrdi/n8n-nodes-puppeteer-extended

nodes/Puppeteer/puppeteer/index.ts

main


      
          				const returnData = await exec(
          					data.nodeParameters,
          					data.executionId,
          					data.continueOnFail
          				);
          
          				ipc.server.emit(socket, "exec", returnData);
          			}
          		);
          
          		ipc.server.on(
          			"check",
          			async (
          				data: { executionId: string; apiKey: string; baseUrl: string },
          				socket: any
          			) => {
          				ipc.server.emit(socket, "check", true);
          				if (
          					data.executionId &&
          					data.apiKey &&
          					state.executions[data.executionId] &&

If I am reading this right, what it is doing is it periodically checks if the execution is still happening (the workflow is still running) by using n8n api and if not - terminates the browser interaction.

So, to answer your question, the credentials needed to be configured is n8n api key (Settings - n8n API) and it needs it to terminate puppeteer when the workflow is done.

wizi · September 3, 2025, 6:24am

Thanks @jabbson been lurking for quite some time
Thanks for the help and the file digging, I understand better now the way pup works.

Yet, I’m still facing a problem, not sure if it’s a brain fart on my end or a real issue:

I got the API up:

But nothing shows up in the “Select Credential to connect with“ drop box:

What am I missing?

Thank for the help so far

wizi · September 3, 2025, 8:47am

It was a brain fart, all is OK now.
Thank you so much @jabbson

system · September 10, 2025, 8:47am

This topic was automatically closed 7 days after the last reply. New replies are no longer allowed.