NetSuite REST icon

NetSuite REST

Call NetSuite SuiteTalk REST operations.

Actions979

Gift Certificate Item → Insert record

AI-generated

Summary

Create a new Gift Certificate Item record in NetSuite with optional custom fields, pricing, and validation headers.

Inputs

  • isDebugMode — Include raw request and response data in the output.
  • itemId — Assign a unique internal number or name for the gift certificate.
  • description — Provide a short description shown on sales forms.
  • price — Define price levels and amounts for the item.
  • customFields — Include any NetSuite custom fields for the item.
  • X-NetSuite-Idempotency-Key — UUID ensuring a creation request is processed only once.
  • X-NetSuite-PropertyNameValidation — Select strictness (Error, Warning, Ignore) for property names.
  • X-NetSuite-PropertyValueValidation — Select strictness (Error, Warning, Ignore) for property values.

Output shape

A JSON object containing the created Gift Certificate Item data. If Debug Mode is enabled, the output also includes the full HTTP request and response.

The response follows the NetSuite REST API schema for gift certificate items and may include optional fields such as internalId, createdDate, and other populated properties. Network errors or validation errors are returned as n8n errors.

Examples

Example 1: Create a simple gift certificate with a fixed price

Set itemId to "GC-100", description to "$100 Gift Certificate", price level to default with amount 100, enable Debug Mode.

Example 2: Create a gift certificate with custom fields and idempotency

Set itemId to "GC-200", description to "$200 Gift Certificate", add custom field "promoCode" (string value "SUMMER2024"), set X-NetSuite-Idempotency-Key to a UUID, and leave property validation options as default.

Example 3: Create a gift certificate with advanced properties

Set itemId to "GC-COMPLEX", description to "Complex Gift Certificate", enable isFulfillable, set billing schedule reference, add multiple price levels, and include custom translation entries. Turn on Debug Mode to inspect request payload.

Discussion