# LDAP Add Operation

```javascript
    ldap.add(dn,entryObject,optionalControls,timeVal);
```

* `dn` Dn where the entryObject is to be added.
* `entryObject` LDAP entry object to be added to the provided DN
* `optionalControls` One or more ldap [Control](../controls.MD). _Optional_
* `timeVal` The maxim amount of time the server should take in responding the add operation (in seconds). _Optional_

Example usecase:

```javascript

const entryObject = {
    attr: "objectClass",
    vals: ["person"]
};

ldap.initialize()
    .then( () => {
        return ldap.bind(..,..)
    })
    .then( () => {
        ldap.add(dn,entryObject,optionalControls,timeVal)
    })

```

A promise returning function that wraps the `ldap_add_ext` C asynchronous function from the openldap API. In Case of success it fulfils with  the result from the add function ( whichever controls the user specified). In case of failure, it throws a custom error that can be further inspected for the cause.

Multiple adds can be executed in parallel (only limit to how many adds can be chunked is the ldap server limitation). A small example on how adds can be chunked can be found in the [populate](../../populate.js) script.


## References:

* [LDAP Add manpage](https://linux.die.net/man/3/ldap_add_ext)
* [LDAP Add specs](https://www.ldap.com/the-ldap-add-operation)
* [RFC Add Operation](https://tools.ietf.org/html/rfc4511#section-4.7)