> For the complete documentation index, see [llms.txt](https://docs.rishvi.co.uk/linnworks/llms.txt).
> Use it to discover all available pages before exploring further.
# Missing Phone Number and Email
Automatically update missing customer phone numbers and email addresses in selected Linnworks orders using predefined default values.
Incomplete customer contact information can create delays during order processing, dispatch, and courier validation. The *Missing Phone Number and Email* macro helps ensure selected Linnworks orders contain the required customer phone number and email address before they move further through the fulfilment process.
This macro checks each selected order, identifies missing or placeholder contact details, and applies predefined default values where required. By automating this process, your team can reduce manual corrections, improve dispatch readiness, and avoid unnecessary fulfilment delays.
With this automated approach, you can maintain cleaner order data and ensure selected orders are updated consistently before dispatch.
> Keep order contact information complete by automatically filling missing phone numbers and email addresses before fulfilment.
## **Configure the Macro**
Once the app is installed, you need to create a macro configuration so the system knows which macro to run, when to run it, and which default contact details should be applied.
This setup can be adjusted anytime based on your operational requirements.
### **Steps to Configure**
**Go to Apps > Macro Configuration and click + Add new configuration.**
**Select the AddMissingPhoneAndEmail macro and click Create Configuration**
This creates a new configuration where you can define the schedule and required parameter values.
**In the Macro Configuration screen, add the configuration name and parameter values.**
**Make sure to enable the macro to continue with the Rule Engine configuration.**
**Note:** If the macro is not enabled, it will not appear in the **Action** value list when setting up the rule.
**Go to Orders > Rules engine and click + Add new rule.**
**Key Benefits**
**Enter the rule name and click Create.**
**Click Add new, select Condition, set the condition as required, and save it.**
**Add the macro action and click Save.**
In the **Add action** window, enter the **Action name**, for example:
`MissingPhoneAndEmail`
- Set **Action type** to:
`Execute a macro`
- In **Action value**, select:
`AddMissingPhoneAndEmail`
- Click **Save**
**Note:** If the macro is not enabled, it will not appear in the **Action** value list when setting up the rule.
**Review the saved rule setup.**
- Verify the condition and action are connected correctly
- Click **Save** in the bottom-right corner to save the rule
Missing phone numbers and email addresses can cause operational issues, especially when couriers or fulfilment teams require complete customer contact details. This macro helps reduce those issues by automatically correcting selected orders.
Eliminates the need to manually open each selected order and check whether customer phone numbers or email addresses are missing.
Ensures selected orders contain the contact information needed before dispatch processing begins.
Helps avoid courier validation problems caused by missing phone numbers or email addresses.
Keeps customer contact fields more consistent by applying predefined default values where data is missing.
Allows teams to correct multiple orders in one macro run instead of updating each order manually.
The macro updates an order only when the phone number or email address needs to be changed.
### How It Works
The macro checks each selected order and updates only the missing or placeholder contact fields. It does not overwrite existing valid contact details.
The macro starts execution and writes **Macro Start** to the log.
It loops through each order ID provided in the **OrderIds** parameter.
For each order, the macro retrieves the order details using the Linnworks Orders API.
It checks the customer phone number. If the value is empty or equals **Phone number: N/A**, the macro applies the configured default phone number.
It checks the customer email address. If the email address is empty, the macro applies the configured default email address.
If any contact information was changed, the macro saves the updated customer information back to the order.
The macro logs any errors and writes **Macro Finished** when execution ends.
### **Usage of App**
This macro is designed to update selected orders automatically once the required parameters are configured. It is useful before dispatch, during order validation, or whenever selected orders need contact information cleanup.
Defines the Linnworks order IDs that should be processed. Only these selected orders are checked and updated.
Defines the phone number that will be applied when an order has an empty phone number or the placeholder value **Phone number: N/A**.
Defines the email address that will be applied when an order has no customer email address.
The macro updates customer information only when at least one contact field has changed.
The macro records the start, errors, and completion of the process using the macro logger.
### **Key Points to Remember**
- The macro processes only the order IDs provided in **OrderIds**
- Existing valid phone numbers are not overwritten
- Existing valid email addresses are not overwritten
- Phone numbers are updated only when empty or set to **Phone number: N/A**
- Email addresses are updated only when empty
- The parameter names in the code are spelled **DefualtPhoneNumber** and **DefualtEmailAddress**
Once the macro is running, it helps ensure selected orders have the basic customer contact details required for smooth order processing.
### **What You Can Expect**
- **Missing phone numbers are automatically updated**\
Orders with empty phone numbers or the placeholder value **Phone number: N/A** receive the configured default phone number
- **Missing email addresses are automatically updated**\
Orders without an email address receive the configured default email address
- **Only required updates are saved**\
Orders are updated only when customer contact information changes
- **Execution is logged**\
The macro records when it starts, finishes, and if an error occurs
- **Improved dispatch preparation**\
Orders are more likely to contain the contact details required before fulfilment
### **Overall Impact**
This macro improves order data completeness, reduces manual corrections, and helps prevent dispatch delays caused by missing customer phone numbers or email addresses.
### What To Do After the Macro Runs
After the macro has completed, review the selected orders if needed to confirm that missing contact information has been populated correctly.
### **Steps to Follow**
Open Linnworks and locate the orders included in the **OrderIds** parameter.
Review the customer contact details on the affected orders.
Confirm that missing phone numbers were replaced with the configured default phone number.
Confirm that missing email addresses were replaced with the configured default email address.
Continue with normal order validation, picking, packing, or dispatch processing.
### **Why This Matters**
Keeping contact details complete helps:
- Reduce courier-related validation issues
- Prevent dispatch delays
- Avoid manual order correction
- Improve order processing accuracy
- Keep customer information consistent
### Best Practices
To get the most value from this macro, configure default values carefully and use the macro as part of your order validation process.
### **Recommended Guidelines**
- **Use realistic default values**\
Make sure the default phone number and email address are accepted by your operational workflow and courier requirements
- **Run before dispatch**\
Use the macro before dispatch processing so contact details are corrected before labels or courier services are applied
- **Review selected orders carefully**\
Ensure the correct order IDs are passed into the macro before running it
- **Avoid using customer-specific defaults**\
Since the macro applies predefined values, use only approved generic values where appropriate
- **Check logs after execution**\
Review macro logs to confirm successful completion or identify any errors
> Correct contact information helps keep order processing smooth and reduces avoidable fulfilment delays.
### **Example Scenario**
To better understand how this works, here’s a simple example:
Configured values:
- **DefualtPhoneNumber** = 0000000000
- **DefualtEmailAddress** = [noemail@example.com](mailto:noemail@example.com)
Selected orders:
- **Order A** has no phone number and no email address → Both fields are updated
- **Order B** has **Phone number: N/A** and a valid email address → Phone number is updated only
- **Order C** has a valid phone number and no email address → Email address is updated only
- **Order D** has both phone number and email address → No update is made
### **What This Means**
- Only missing or placeholder contact values are updated
- Existing valid customer contact details are preserved
- Your team can focus on processing orders instead of manually correcting contact fields
## **Final Summary**
The *Missing Phone Number and Email* macro helps keep selected Linnworks orders ready for dispatch by automatically filling missing customer contact details with predefined default values.
By reducing manual checks, improving data completeness, and updating only the orders that require correction, this macro supports smoother fulfilment and more reliable order processing.