====== NotificationRequest ======

==== Overview ====

**NotificationRequest** allows an application to programmatically send any notification.


**Learn More:**

  * [[:developer_guide:developer_guide#using-the-apis|Using the APIs]]  
  * [[:developer_guide:developer_guide#http-status-code|HTTP Status Codes]]  
  * [[:developer_guide:developer_guide#error-codes|Error Codes]] 
  * [[:developer_guide:developer_guide#troubleshooting|Troubleshooting]] 

===== NotificationRequest =====



==== XML ====

<code>

<?xml version="1.0" encoding="utf-8"?>
    <NotificationRequest>
	<Username>string</Username>	
        <Token>string</Token>
        <GUID>string</GUID>
        <Action>string</Action>	
    </NotificationRequest>

</code>



==== Elements ====



^ Name ^ Type ^ Occurrence  ^ Meaning ^
| **NotificationRequest** | container | required | Parent Element |
| Username | string | required | Merchant API Username (Not your Merchant Center login) |
| Token| string | required | Hash of API Username and Password. [[:developer_guide:developer_guide:LinkID|Creating a Token]] |
| Guid | string | always | This is the identifier for the subscription and should be referenced in future management requests |
| Action | string | required | The notification name you wish to send. |


===== NotificationResponse =====


==== XML ====

<code>

<?xml version="1.0" encoding="utf-8"?>
    <NotificationResponse>	
        <Ack>string</Ack>
	<Timestamp>timestamp</Timestamp>	
    </NotificationResponse>

</code>



==== Elements ====


^ Name ^ Type ^ Occurrence  ^ Meaning ^
| **NotificationResponse** | container | required | Parent Element |
| Ack | string | always | Success, Error, or Warning |
| Timestamp | string | always | All responses return the official SB time stamp in UTC/GMT |
| Message | string | conditionally | A message with helpful information for the end user |