Understanding the error code 409 when creating a Fragment for Custom Template in Verify API V2. Understanding the error code 409 when creating a Fragment for Custom Template in Verify API V2.

Understanding the error code 409 when creating a Fragment for Custom Template in Verify API V2.

Vonage API Support

Question

Why I'm receiving the error code 409 "A template fragment for this channel and locale already exists" when creating a Fragment for Custom Template in Verify API V2?

Applies To

  • Verify API V2
  • Custom Template
  • Template Management
  • SMS
  • Voice/TTS

Answer

The Custom Template/Template Management feature in Verify API V2 has more capabilities compared with the Verify API V1 (Legacy), which allows an API key to have multiple template IDs. Each template_id can include multiple fragment IDs, and within a single template_id, each combination of locale+channel can only have one fragment_id. Below is the detailed diagram sample:
Verify API V2 Custom Template:Template Management Diagram.png

 

The above fragment_id "zzz-zzz" will not be allowed because the same combination of locale+channel is already defined in the fragment_id "ccc-ccc" with the same value channel "sms"+locale "es-es".

Additional Information

The complete Custom Template's API references can be found here