Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

...

ParameterDescriptionExample
Id always set to zero 
IdListSpecify here MailUp list ID (or 'NULL'zero, if filter is applicable to all lists) 
NameNumber that identifies console IDFilter name 
Description Filter description (free text) 
Category Category ID. Each filter should belong to a category, IDs can be retrieved by reading from tooltips (more on this) 
Conditions[ ]

Array of conditions (at list one). Each condition is composed of the following fields:

  • Id (always set to zero)
  • IdFilter (always set to zero)
  • LogicalOperation (allowed values: AND, OR"None for the first condition, "Or" for the other conditions)
  • Type (allowed values: "UserIsLocatedIn" and "UserIsNotLocatedIn")
  • Country (country code, check this table)
  • Region (region name, check this table)
 

SOAP Examples

Code Block
languagehtml/xml
titleSOAP request
coming soon<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ifil="http://Mailup.WS/IFilterService">
<soapenv:Header/>
<soapenv:Body>
	<ifil:FiltersCreateGeographicFilter>
		<ifil:request>
			<ifil:AccessToken>ykpSh06dkwEv+Mrogyv4U59837ftsZUNRaAxODcpxYAni4VOKmxvoLzAIul5PIo89E1ecrUqUY59M=</ifil:AccessToken>
			<ifil:Filter>
				<ifil:Id>0</ifil:Id>
				<ifil:IdList>2</ifil:IdList>
				<ifil:Name>MailUp headquarters</ifil:Name>
				<ifil:Description>Recipients located near MailUp headquarters</ifil:Description>
				<ifil:Category>4</ifil:Category>
				<ifil:Conditions>
					<ifil:GeographicFilterCondition>
						<ifil:Id>0</ifil:Id>
						<ifil:IdFilter>0</ifil:IdFilter>
						<ifil:LogicalOperation>None</ifil:LogicalOperation>
						<ifil:Type>UserIsLocatedIn</ifil:Type>
						<ifil:Country>IT</ifil:Country>
						<ifil:Region>LOMBARDIA</ifil:Region>
					</ifil:GeographicFilterCondition>
					<ifil:GeographicFilterCondition>
						<ifil:Id>0</ifil:Id>
						<ifil:IdFilter>0</ifil:IdFilter>
						<ifil:LogicalOperation>Or</ifil:LogicalOperation>
						<ifil:Type>UserIsLocatedIn</ifil:Type>
						<ifil:Country>US</ifil:Country>
						<ifil:Region>CALIFORNIA</ifil:Region>
					</ifil:GeographicFilterCondition>
				</ifil:Conditions>
				<ifil:Precision>Low</ifil:Precision>
			</ifil:Filter>
		</ifil:request>
	</ifil:FiltersCreateGeographicFilter>
</soapenv:Body>
</soapenv:Envelope>
Code Block
languagehtml/xml
titleSOAP response
coming soon<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <FiltersCreateGeographicFilterResponse xmlns="http://Mailup.WS/IFilterService">
         <FiltersCreateGeographicFilterResult>
            <Filter>
               <Id>57</Id>
               <IdList>2</IdList>
               <Name>MailUp headquarters</Name>
               <Description>Recipients located near MailUp headquarters</Description>
               <Category>4</Category>
               <Conditions>
                  <GeographicFilterCondition>
                     <Id>45</Id>
                     <IdFilter>57</IdFilter>
                     <LogicalOperation>None</LogicalOperation>
                     <Type>UserIsLocatedIn</Type>
                     <Country>IT</Country>
                     <Region>LOMBARDIA</Region>
                  </GeographicFilterCondition>
                  <GeographicFilterCondition>
                     <Id>46</Id>
                     <IdFilter>57</IdFilter>
                     <LogicalOperation>Or</LogicalOperation>
                     <Type>UserIsLocatedIn</Type>
                     <Country>US</Country>
                     <Region>CALIFORNIA</Region>
                  </GeographicFilterCondition>
               </Conditions>
               <Precision>Low</Precision>
            </Filter>
         </FiltersCreateGeographicFilterResult>
      </FiltersCreateGeographicFilterResponse>
   </s:Body>
</s:Envelope>

FiltersDeleteGeographicFilter

...

Code Block
languagehtml/xml
titleSOAP request
coming soon<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ifil="http://Mailup.WS/IFilterService">
<soapenv:Header/>
<soapenv:Body>
	<ifil:FiltersDeleteGeographicFilter>
	<ifil:request>
		<ifil:AccessToken>5JTPq1MRiKnMa07AbT81qTjtravi3IFb6m9aVI6Nfw+dr+iYKMWDVS5D8byhzpy4aPOcaNawNfVnqa0=</ifil:AccessToken><ifil:IdFilter>57</ifil:IdFilter>
	</ifil:request>
	</ifil:FiltersDeleteGeographicFilter>
</soapenv:Body>
</soapenv:Envelope>
Code Block
languagehtml/xml
titleSOAP response
coming soon<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <FiltersDeleteGeographicFilterResponse xmlns="http://Mailup.WS/IFilterService">
         <FiltersDeleteGeographicFilterResult/>
      </FiltersDeleteGeographicFilterResponse>
   </s:Body>
</s:Envelope>