WoowUp Developer Docs
Woowup
  • Getting Started (EN)
  • Primeros Pasos (ES)
  • API
    • Users
    • Purchases
    • Products
    • Benefits
    • Coupons
    • Events
      • Garantía Extendida
    • Custom Attributes
    • Branches
    • Blacklist
    • Abandoned carts
    • Reset account
    • Integration Stats
    • Categories
    • Segment Export
  • Web Tracking
    • Configuración Navegación Web
  • Push Notifications
    • Configuración Notificaciones Web Push en Magento / Web Custom
    • Configuración Push en VTEX Legacy
    • Configuración Push en VTEX IO
    • ¿Cómo saber si la configuración fue exitosa?
  • Formularios Web
    • Formulario HTML / Script JS Newsletter
  • VTEX
    • Conectar Cuenta
    • Trigger Carrito Abandonado
    • Trigger Newsletter
    • VTEX APP Instalación
    • VTEX APP Configuración
  • Magento 1
    • Conectar Cuenta
    • Extension Carrito Abandonado
  • Magento 2
    • Conectar Cuenta
  • Shopify
    • Conectar Cuenta
  • Woocommerce
    • Conectar Cuenta
    • Extensión Carrito Abandonado
  • Prestashop
    • Conectar Cuenta
  • E3
    • Conecta tu eCommerce E3
  • Tienda Nube
    • Conectar Cuenta
  • Mensajería
    • SendGrid: Conectar Cuenta
    • Perfit: Conectar Cuenta
    • Infobip: Conectar Cuenta
  • Editor de campañas
    • Motor de template de emails
  • Data Processing
    • WoowUp Connectors
    • Migración a Multi - ID
  • How To
    • SurveyKiwi: Conectar Cuenta
      • Untitled
    • Snappy: Conectar Cuenta
    • Zendesk: Conectar Cuenta
  • Integración CSV / SQL
    • Primeros pasos
    • Archivo de Tiendas
    • Archivo de Categorías
    • Archivo de Productos
    • Archivo de Clientes
    • Archivo de Ventas
    • Archivo de Medios de Pago
    • Archivo de Miembros de Familia
  • Validación de Datos
  • ¿Cómo completar el Blueprint?
Powered by GitBook
On this page
  • Getting started
  • Authentication
  • Pagination
  • Returned format
  • How to encode 'service_uid'
  • Sample Code: How to start sending us your purchase orders
  • Support

Was this helpful?

Getting Started (EN)

Welcome! Here you will find examples and a detailed endpoint list that will let you integrate WoowUp with the systems you use.

NextPrimeros Pasos (ES)

Last updated 6 months ago

Was this helpful?

Getting started

This is a REST-style API that uses JSON for serialization. To start using the API you will need:

  1.Log into WoowUp and get your Api Key from the Configuration/MyAccount section.   2.Read the API docs to understand what you can do.

Basics

  • The API is limited to 10 request/second. If you overpass this limit you’ll receive an exception.

  • All request receive and return data in JSON format.

  • Remember to include in the header Basic Authentication when calling any endpoint. you’ll find how to do it.

  • To identify a customer use the field “service_uid”. Normally you will use the email or the ID (DNI, CPF, RUT, Passport) to identify the customer.

  • Every time you are going to use service_uid as part of the URL, first you’ll need to encode it with base64 and then with url encode. You can read here a detailed explanation .

  • Valid date formats are: YYYY-mm-dd HH:mm:ss (default in UTC) or ISO8601 format including the timezone Ex: 2004-02-12T15:19:21+03:00

  • Normally you’ll include al the Product Information (sku, title, category, stock, etc) within the Create purchase order endpoint. But if you prefer, there is a specific endpoint to synchronize .

  • Before send a purchase order, you need to create the customer if it doesn't exist. In the example you can see how this process works in the "import_from_csv.php" file.

  • Please, pay attention to the messages of the responses of our API because we will tell you if something is wrong with your requests or the information you send.

Authentication

In any call to the API you must sent the apikey in the query string as a parameter.

For example, if your apikey is 'abcdefghijklmnopqrstuvwxyz', you should do a request to

https://api.woowup.com/apiv3/users?apikey=abcdefghijklmnopqrstuvwxyz

Other method, and the recomended, is via Authentication Header, in every call you must send the header

Authorization: Basic abcdefghijklmnopqrstuvwxyz

Pagination

When you are doing a search, we paginate the results. In all paginated endpoints the pagination's parameters are:

Parameter

Description

Default

limit

Items per page returned. Max: 100

25

page

Number of the page. First page is 0

0

Returned format

All endpoints return data in json format, with the Content-Type: application/json header. For a correct use you have to send in all the requests the header Accept: application/json.

How to encode 'service_uid'

When you are trying to find an user you could identificate this by his id or his service_uid (commonly is the email), when you use the service_uid you must encode this in Base64 en the result encode as url safe, for example if you need to do this in php:

<?php

$service_uid = 'example@email.com';
$encoded_uid = urlencode(base64_encode($service_uid));
$url = 'https://api.woowup.com/apiv3/users/'.$encoded_uid.'/exist';

Sample Code: How to start sending us your purchase orders

Support

In the following link you will find a fully functional example in PHP that process a CSV file with orders and customers and use the API to send them to WoowUp:

Remember to contact us on for any questions, we will be happy to assist you.

Download example
developers@woowup.com
Here
here
products