API Key Generation Process

Follow these steps to generate an API key for accessing Wuilt's GraphQL API:

Step 1: Log in to Your Wuilt Account

1. Navigate to Wuilt's login page

Step 2: Access the Dev tools Section

1. From the left sidebar menu, scroll down to SETTINGS
2. Click on Dev Tools at the bottom of the settings menu

Step 3: API Key Generator

Click on API Key Generator card.

Step 4: Initiate API Key Generation

1. In the API Key Generator dashboard.
2. Click on Generate API Key button

Step 4: Configure Your API Key

1. Enter a descriptive name for your key (e.g., "MyStoreIntegration")
2. Select the specific permissions you want to attach to this key:
   • Products
   • Orders
   • Customers
   • Discounts
   • etc.
3. Review the permissions carefully

Step 5: Generate the Key

1. Click the Generate API Key button
2. Wait for the system to create your secure key

Step 6: Secure Your API Key

1. Immediately copy the generated key displayed on screen
   • Example key: qPwPCWPrmhMDqUFxxsTymWJfSaE7AY6tEZjIfoFX_OKs
2. Store it in a secure location like a password manager
3. Important: This key will only be shown once and cannot be retrieved later

Step 7: Final Confirmation

1. Check the box: "Confirm that I have copied this key and stored it safely"
2. Click Proceed to complete the process

API Endpoint & Authentication

Now that you have your API key, here's how to use it to make requests to the Wuilt GraphQL API.

GraphQL Endpoint

https://graphql.wuilt.com/

Authentication

Include your API key in the request headers:

X-API-KEY: YOUR_API_KEY

Example Request

Using JavaScript/Node.js:

const response = await fetch("https://graphql.wuilt.com/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-KEY": "your_api_key_here",
  },
  body: JSON.stringify({
    query: `
      query GetStoreInfo($storeId: String!) {
        store(id: $storeId) {
          id
          name
          email
        }
      }
    `,
    variables: {
      storeId: "your_store_id",
    },
  }),
});

const data = await response.json();
console.log(data);

Using cURL:

curl -X POST https://graphql.wuilt.com/ \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your_api_key_here" \
  -d '{
    "query": "query GetStoreInfo($storeId: String!) { store(id: $storeId) { id name email } }",
    "variables": { "storeId": "your_store_id" }
  }'

Next Steps

1. Get your Store ID: Visit the Store ID guide to find your store identifier
2. Explore the API: Use our interactive GraphQL playground to test queries
3. Set up Webhooks: Configure real-time notifications for your store events
4. Get AI Help: Use Context7 AI Assistant to chat with the documentation and get instant code examples

Best Practices

• 🔐 Never share your API key publicly or commit it to version control
• 🔄 Rotate keys periodically for better security
• 🚫 Revoke immediately if you suspect unauthorized access
• 📁 Store securely using encrypted secrets management

Troubleshooting

If you lose your API key:

1. You must generate a new key
2. Update all applications using the old key
3. The previous key will be automatically deactivated