Create a record in NetSuite using the SuiteTalk REST API

domain: docs.oracle.com/en/cloud/saas/netsuite · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

In-depth guide

NetSuite SuiteTalk REST authentication — the full failure-mode walkthrough related to docs.oracle.com/en/cloud/saas/netsuite, checked against official docs, with linked verified routes.

Steps

  1. Configure OAuth 1.0a credentials in NetSuite (Integration record + Access Token); collect the account ID, consumer key/secret, and token key/secret.
  2. Construct the base URL using your account ID: https://{accountId}.suitetalk.api.netsuite.com/services/rest/record/v1/{recordType}.
  3. Sign the HTTP request using OAuth 1.0a signature method (HMAC-SHA256); include the Authorization header with oauth_consumer_key, oauth_token, oauth_signature_method, oauth_timestamp, oauth_nonce, and oauth_signature.
  4. POST the record body as JSON; for example, to create a vendor bill, include entity (vendor internal ID), tranDate, and itemList or expenseList arrays.
  5. Parse the 204 response; the Location header contains the URL of the newly created record, from which you can extract the internal ID.
  6. To read the record back, issue a GET to the URL from the Location header.

Known gotchas

Related routes

Create and retrieve NetSuite custom record instances via REST Record API versus SuiteTalk SOAP
docs.oracle.com · 6 steps · unrated
Create, read, update, and delete a salesOrder record using the NetSuite SuiteTalk REST Record API
docs.oracle.com/en/cloud/saas/netsuite · 6 steps · unrated
Create an assembly build record with component substitution in NetSuite via the SuiteTalk REST API, setting lot numbers on consumed components
docs.oracle.com/en/cloud/saas/netsuite · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans