> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maesn.com/llms.txt
> Use this file to discover all available pages before exploring further.
# weclapp
> Integrate weclapp easily with Maesn’s Unified API. See the documentation with detailed system coverage and setup prerequisites.
**TARGET\_SYSTEM:** `weclapp`
| | Read | Create | Update | Delete | Webhook |
| -------------------- | :----------------------------------------------------: | :----------------------------------------------------: | :----------------------------------------------------: | :----------------------------------------------------: | :----------------------------------------------------: |
| Accounts | | | | | |
| Async task | | | | | |
| Bank accounts | | | | | |
| Bills | | | | | |
| Bill lines | | | | | |
| Booking proposals | | | | | |
| Contacts | | | | | |
| Customers | | | | | |
| Credit notes | | | | | |
| Dimensions | | | | | |
| Expenses | | | | | |
| Files | | | | | |
| Fiscal years | | | | | |
| Goods receipts | | | | | |
| Goods receipt lines | | | | | |
| Invoices | | | | | |
| Invoice lines | | | | | |
| Items | | | | | |
| Journals | | | | | |
| Journal entries | | | | | |
| Offers | | | | | |
| Offer lines | | | | | |
| Open items | | | | | |
| Payments | | | | | |
| Payment terms | | | | | |
| Projects | | | | | |
| Purchase orders | | | | | |
| Purchase order lines | | | | | |
| Sales orders | | | | | |
| Sales order lines | | | | | |
| Suppliers | | | | | |
| Tax rates | | | | | |
| Transactions | | | | | |
| Trial balance | | | | | |
| Units | | | | | |
| Users | | | | | |
| Vendor credits | | | | | |
= Supported by Maesn
= On demand - contact us
= Not supported by weclapp
## How to connect to weclapp
As a customer of weclapp, you can easily retrieve the API key used for connecting to your weclapp data.
Before you begin, make sure you have the following:
* A weclapp account with administrator permissions to generate and retrieve the Personal Access Token.
You can sign-up for a free trial at [https://www.weclapp.com/en/register/](https://www.weclapp.com/en/register/), if you do not have a weclapp account already.
Please note: you must replace 'weclappTenantId' inside the url's paths with the id of your instance of weclapp.
Log in to weclapp using your account credentials and the provided url, properly edited with your weclapp tenant id, to generate and retrieve the Access Token: [retrieve the Access Token](https://weclappTenantId.weclapp.com/webapp/view/settings/GeneralSettingsOverview.page).
Enter your password in the 'API token' section to generate new API keys.
Paste your weclapp api token in to the 'API key' field and your weclapp tenant id in to the 'weclapp Tenant Id' field in maesn Connect and press 'submit'. If the Token and the weclapp Id are valid, the connection will be established and a success message will be displayed.
Your weclapp account is now connected!
## Webhooks
Weclapp supports the following parameters for webhooks:
Resources:
* `CUSTOMER`
* `SUPPLIER`
* `INVOICE`
* `CREDIT_NOTE`
* `SALES_ORDER`
Event types:
* `CREATED`
* `UPDATED`
* `DELETED`
Weclapp needs both resource and event type to be able to send webhook events.
The subscription is created **per customer**, which means for each customer, you will create a customized subscription for the events and resources you want to be notified about.
To set this up, call Maesn's create webhook endpoint `POST /webhooks?companyId=` (`companyId` query parameter required if not using the interactive flow) with the following example body:
```javascript Example code snippet theme={null}
const response = await axios.post(url, {
"callbackUrl": callbackUrl,
"eventType": "CREATED",
"resource": "CUSTOMER"
}, {
headers: {
'X-API-KEY': apiKey,
'X-ACCOUNT-KEY': accountKey
}
});
```
It will return the `id` associated with the subscription:
```json Example response theme={null}
{
"data": {
"id": "830251",
"callbackUrl": "https://example.com/webhook-endpoint/12345",
"createdDate": null,
"expiresDate": "null",
"secret": "2f1fd5f883d4c0adf5b31b91e4d6ae2d2975620c67bac8fdb864c78047b1d522"
"updatedDate": "null"
},
"meta": {}
}
```
At this point, your system is ready to receive end-user–related events at the callback URL you provided. The event response will provide the following information:
```json Example event body theme={null}
{
"eventType": "CREATED",
"filterDate": null, //not supported by weclapp
"resource": "CUSTOMER",
"resourceId": "1605408d-ed88-4228-8a12-ab857a2972d8",
"userId": null //not supported by weclapp
}
```
To delete the webhook subscription, you can call the `DELETE` `/webhooks/{webhookId}?companyId=` endpoint provinding both your `X-API-KEY` and the end user `X-ACCOUNT-KEY`.