> For the complete documentation index, see [llms.txt](https://developer.gyfti.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.gyfti.fr/retrieve-data-from-campaigns/new-order.md).

# New order

#### Data you can retrieve with this call

| Data field           | Description                                                                                             | Field types |
| -------------------- | ------------------------------------------------------------------------------------------------------- | ----------- |
| Recipient email      | your contact recipient's email address. This key can be used to identify your contact in your software. | text        |
| Recipient first name | your contact recipient's first name                                                                     | text        |
| Recipient last name  | your contact recipient's last name                                                                      | text        |
| Recipient company    | your contact recipient's company                                                                        | text        |
| Product Name         | the product that was sent to your recipient                                                             | text        |
| Order status         | the status of the order                                                                                 | text        |
| Charity              | the name of the charity your recipient chose to convert to                                              | text        |
| Cost excl tax        | the cost of the product sent to your recipient excluding taxes but including shipping                   | number      |
| Cost incl tax        | the cost of the product sent to your recipient inclusing taxes and shipping                             | number      |
| Created date         | the date the order was created                                                                          | date        |
| Sender Email         | the user who sent the campaign's email                                                                  | text        |
| Sender first name    | the user who sent the campaign's first name                                                             | text        |
| Sender last name     | the user who sent the campaign's last name                                                              | text        |
| Campaign Name        | the campaign name of this order                                                                         | text        |

## Retrieve by webhook new orders on you company account

<mark style="color:green;">`POST`</mark> `https://app.gyfti.fr/api/1.1/wf/new_hook_order/`

By using this call, you will send gyfti app your webhook url.

For each new order, your webhook will receive data

#### Headers

| Name                                            | Type   | Description             |
| ----------------------------------------------- | ------ | ----------------------- |
| Authorization<mark style="color:red;">\*</mark> | String | 'Bearer \[YOUR\_TOKEN]' |

#### Request Body

| Name                                      | Type   | Description          |
| ----------------------------------------- | ------ | -------------------- |
| hookUrl<mark style="color:red;">\*</mark> | String | {YOUR\_WEBHOOK\_URL} |
| user                                      | String | <user@email.com>     |

{% tabs %}
{% tab title="200: OK success" %}

```json
{
  "Recipient Email": "recipienttest@gyfti.fr",
  "Recipient First Name": "Recipient test FirstName",
  "Recipient Last Name": "Recipient test LastName",
  "Recipient Company": "Recipient test Company",
  "Product Name": "Product name",
  "Order Status": "Order status Commandé",
  "Charity": "Charity test",
  "Cost excl tax": "10",
  "Cost incl tax": "12",
  "Created date": "2023-01-05",
  "Sender Email": "sendertest@gyfti.fr",
  "Sender First Name": "Sender test FirstName",
  "Sender Last Name": "Sender test LastName",
  "Campaign Name": "Campaign Test Order",
  "Product Type": "Product Type"
}
```

{% endtab %}
{% endtabs %}