ElevenLabs icon

ElevenLabs

WIP

Actions13

Overview

The Create Voice operation in the "Voice" resource of this n8n node allows you to add a new custom voice to your ElevenLabs library using a previously generated generated_voice_id. This is useful for users who have generated a synthetic voice (for example, via a "Generate Voice" operation) and now want to save it for future use or sharing. Typical scenarios include building automated workflows for content creation, voiceover generation, or managing a collection of custom voices for various projects.

Example Use Cases:

  • Automating the process of adding newly generated voices to your ElevenLabs account.
  • Organizing and labeling custom voices for different projects or clients.
  • Integrating voice management into larger content production pipelines.

Properties

Display Name Type Meaning
Generation Voice ID String The unique identifier (generated_voice_id) of the voice you previously generated. Required to create the new voice.
Name String The name to assign to the new voice in your library. Defaults to "n8n voice".
Additional Fields Collection Optional fields to further describe the voice:
  Description String A description for the voice. Default: "Generate with n8n".
  Labels (JSON) JSON Labels to categorize or describe the voice (up to 5). Example: language, descriptive tags, etc.

Note: There are also informational notice properties that provide guidance and updates about the node, but they do not affect execution.

Output

The output will be a JSON object containing details about the newly created voice. While the exact structure depends on the ElevenLabs API response, you can expect fields such as:

{
  "voice_id": "string",
  "name": "string",
  "description": "string",
  "labels": {
    "language": "en",
    "descriptive": "custom voice",
    "generated": "with n8n"
  },
  // ...other metadata returned by the API
}
  • If the operation fails, an error message will be included in the output.

Dependencies

  • External Service: Requires access to the ElevenLabs API.
  • API Key: You must configure valid ElevenLabs API credentials in n8n under the credential type elevenLabsApi.
  • n8n Configuration: No additional configuration required beyond setting up the credentials.

Troubleshooting

Common Issues:

  • Missing or Invalid generated_voice_id: If the provided ID is missing or incorrect, the API will likely return an error indicating the voice could not be found or created.
  • Invalid Labels JSON: If the labels field is not valid JSON or exceeds the maximum allowed labels (5), the request may fail.
  • Authentication Errors: If your API key is missing or invalid, you'll receive authentication errors from the API.

Error Messages and Resolutions:

  • "Invalid generated_voice_id": Ensure you are using a valid ID obtained from a successful "Generate Voice" operation.
  • "Unauthorized" or "Invalid API Key": Check your ElevenLabs API credentials in n8n.
  • "Too many labels": Limit the number of labels in the JSON to 5 or fewer.

Links and References

Discussion